FileSystemEntry: метод remove()

Устаревший: Эта функция больше не рекомендуется. Хотя некоторые браузеры могут её всё ещё поддерживать, она может быть удалена из соответствующих веб-стандартов, находится в процессе удаления или поддерживается только для совместимости. Избегайте её использования и, если возможно, обновите существующий код; см. таблицу совместимости в конце этой страницы, чтобы принять решение. Имейте в виду, что эта функция может перестать работать в любое время.

Нестандартный: Эта функция нестандартна и не входит в стандарт. Не используйте её на сайтах, которые доступны в интернете: она не будет работать для каждого пользователя. Также могут быть значительные несовместимости между реализациями, и поведение может измениться в будущем.

Метод интерфейса FileSystemEntry remove() удаляет файл или директорию из файловой системы. Директории должны быть пустыми, прежде чем их можно будет удалить.

Для рекурсивного удаления директории, а также всех её содержимого и поддиректорий, вызовите FileSystemDirectoryEntry.removeRecursively() вместо этого.

Синтаксис

remove(successCallback)
remove(successCallback, errorCallback)

Параметры

successCallback: Функция, которая вызывается после успешного удаления файла.
errorCallback Необязательно: Необязательный обработчик, который вызывается, если попытка удалить файл завершается неудачно.

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

None (undefined).

Исключения

FileError.INVALID_MODIFICATION_ERR: Указанная запись была корневым каталогом файловой системы, или указанная запись — это директория, которая не пуста.
FileError.INVALID_STATE_ERR: Кэшированное состояние файловой системы не соответствует её состоянию на диске, поэтому файл не может быть удалён по соображениям безопасности.
FileError.NO_MODIFICATION_ALLOWED_ERR: Состояние файловой системы не позволяет удалить файл или директорию.
FileError.NOT_FOUND_ERR: Файл или директория не существует.
FileError.SECURITY_ERR: Запись не может быть удалена из-за ограничений по правам доступа или других ограничений доступа, или потому что производится слишком много вызовов на ресурсы файлов.

Примеры

В этом примере удаляется временный рабочий файл.

workingDirectory.getFile(
  "tmp/work-file.json",
  {},
  (fileEntry) => {
    fileEntry.remove(() => {
      /* the file was removed successfully */
    });
  },
  handleError,
);

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

	Рабочий стол					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`remove`	8	79	Нет	Нет	Нет	18	Нет	14	Нет	1.0	≤37

См. также

© 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/FileSystemEntry/remove