FileSystemDirectoryHandle: метод removeEntry()

Базовая версия 2023

Новое

С марта 2023 года эта функция работает на последних устройствах и версиях браузеров. Эта функция может не работать на более старых устройствах или браузерах.

Безопасный контекст: Эта функция доступна только в безопасных контекстах (HTTPS) в некоторых или во всех поддерживающих браузерах.

Примечание: Эта функция доступна в Web Workers.

Метод removeEntry() интерфейса FileSystemDirectoryHandle пытается удалить запись, если в каталоге есть файл или каталог с указанным именем.

Синтаксис

removeEntry(name)
removeEntry(name, options)

Параметры

name

Строка, представляющая FileSystemHandle.name записи, которую вы хотите удалить.

options Необязательно

Необязательный объект, содержащий параметры:

recursive Необязательно: Булево значение, по умолчанию false. При значении true записи будут удалены рекурсивно.

Возвращаемое значение

A Promise, который завершается успехом undefined.

Исключения

TypeError: Выбрасывается, если имя не является корректной строкой или содержит символы, запрещенные в файловой системе.
NotAllowedError DOMException: Выбрасывается, если PermissionStatus.state для обработчика не 'granted' в режиме readwrite.
InvalidModificationError DOMException: Выбрасывается, если recursive установлено в false, а удаляемая запись имеет дочерние элементы.
NotFoundError DOMException: Выбрасывается, если текущая запись не найдена, или запись с указанным именем не найдена или не соответствует.

Примеры

В следующем примере удаляется запись внутри обработчика каталога.

const entryName = "entryToRemove";

// assuming we have a directory handle: 'currentDirHandle'
currentDirHandle.removeEntry(entryName).then(() => {
  // code to run if removing was successful
});

Спецификации

Спецификация
Файловая система # api-filesystemdirectoryhandle-removeentry

Совместимость с браузерами

	Рабочий стол					Мобильный
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`removeEntry`	86	86	111	72	15.2	109	111	74	15.2	21.0	109

См. также

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle/removeEntry