FileSystemEntry

Интерфейс FileSystemEntry API для файлов и каталогов представляет собой отдельную запись в файловой системе. Запись может быть файлом или каталогом (каталоги представлены интерфейсом FileSystemDirectoryEntry). Он включает методы для работы с файлами — включая копирование, перемещение, удаление и чтение файлов — а также информацию о файле, на который он указывает, включая имя файла и путь от корня к записи.

Вы не создаёте объекты FileSystemEntry напрямую. Вместо этого вы получите объект, основанный на этом интерфейсе, через другие API. Этот интерфейс служит базовым классом для интерфейсов FileSystemFileEntry и FileSystemDirectoryEntry, которые предоставляют функции, специфичные для записей файловой системы, представляющих файлы и каталоги соответственно.

Интерфейс FileSystemEntry включает методы, которые вы ожидаете для управления файлами и каталогами, но также включает удобный метод для получения URL записи: toURL(). Он также вводит новую схему URL: filesystem:.

Вы можете использовать схему filesystem: в Google Chrome, чтобы увидеть все файлы и папки, хранящиеся в источнике вашего приложения. Просто используйте схему filesystem: для корневого каталога источника приложения. Например, если ваше приложение находится по адресу http://www.example.com, откройте filesystem:http://www.example.com/temporary/ в новой вкладке. Chrome отобразит только для чтения список всех файлов и папок, хранящихся в источнике вашего приложения.

Чтобы увидеть пример работы toURL(), см. описание метода. Ниже приведён фрагмент кода, демонстрирующий, как можно удалить файл по имени.

// Taking care of the browser-specific prefixes.
window.requestFileSystem =
  window.requestFileSystem || window.webkitRequestFileSystem;

// …

// Opening a file system with temporary storage
window.requestFileSystem(
  TEMPORARY,
  1024 * 1024 /*1MB*/,
  (fs) => {
    fs.root.getFile(
      "log.txt",
      {},
      (fileEntry) => {
        fileEntry.remove(() => {
          console.log("File removed.");
        }, onError);
      },
      onError,
    );
  },
  onError,
);

Этот интерфейс предоставляет следующие свойства.

filesystem Только для чтения

Объект FileSystem, представляющий файловую систему, в которой расположена запись.

fullPath Только для чтения

Строка, предоставляющая полный, абсолютный путь от корня файловой системы до записи; её также можно рассматривать как путь, относящийся к корневому каталогу, с префиксом "/".

isDirectory Только для чтения

Булево значение, которое равно true, если запись представляет собой каталог; в противном случае оно равно false.

isFile Только для чтения

Булево значение, которое равно true если запись представляет собой файл. Если это не файл, это значение равно false.

name Только для чтения

Строка, содержащая имя записи (конечная часть пути после последнего символа "/").

Этот интерфейс определяет следующие методы.

copyTo() Устаревший Нестандартный

Копирует файл или каталог в новое местоположение в файловой системе.

getMetadata() Устаревший Нестандартный

Получает метаданные о файле, такие как дата и размер его изменения.

getParent()

Возвращает FileSystemDirectoryEntry, представляющий родительский каталог записи.

moveTo() Устаревший Нестандартный

Перемещает файл или каталог в новое местоположение в файловой системе или переименовывает файл или каталог.

remove() Устаревший Нестандартный

Удаляет указанный файл или каталог. Вы можете удалить только пустые каталоги.

toURL() Устаревший Нестандартный

Создаёт и возвращает URL, идентифицирующий запись. Этот URL использует схему URL "filesystem:".

• API для работы с файлами и каталогами
• Введение в API для работы с файлами и каталогами
• FileSystemFileEntry и FileSystemDirectoryEntry основаны на FileSystemEntry.