FileSystemDirectoryEntry

Интерфейс FileSystemDirectoryEntry API «Файлы и каталоги» представляет каталог в файловой системе. Он предоставляет методы, позволяющие получить доступ к файлам в каталоге, управлять ими, а также получить доступ к элементам внутри каталога.

Основные понятия

Вы можете создать новый каталог, вызвав getDirectory(). Если нужно создать подкаталоги, создавайте каждый дочерний каталог последовательно. Если вы попытаетесь создать каталог с полным путем, включающим родительские каталоги, которые еще не существуют, будет возвращено сообщение об ошибке. Поэтому создавайте иерархию, рекурсивно добавляя новый путь после создания родительского каталога.

Пример

В следующем фрагменте кода мы создаем каталог под названием «Документы».

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

// …

function onFs(fs) {
  fs.root.getDirectory(
    "Documents",
    { create: true },
    (directoryEntry) => {
      //directoryEntry.isFile === false
      //directoryEntry.isDirectory === true
      //directoryEntry.name === 'Documents'
      //directoryEntry.fullPath === '/Documents'
    },
    onError,
  );
}

// Opening a file system with temporary storage
window.requestFileSystem(TEMPORARY, 1024 * 1024 /*1MB*/, onFs, onError);

Свойства экземпляра

Этот интерфейс не имеет собственных свойств, но наследует свойства от своего родительского интерфейса FileSystemEntry.

Методы экземпляра

Этот интерфейс наследует методы от своего родительского интерфейса FileSystemEntry.

createReader(): Создает объект FileSystemDirectoryReader, который можно использовать для чтения записей в этом каталоге.
getDirectory(): Возвращает объект FileSystemDirectoryEntry, представляющий каталог, расположенный по заданному пути, относительно каталога, на котором вызывается метод.
getFile(): Возвращает объект FileSystemFileEntry, представляющий файл, расположенный в иерархии каталога, по пути, относительно каталога, на котором вызывается метод.
removeRecursively() Устаревший Нестандартный: Удаляет каталог, а также все его содержимое, итеративно переходя по всей поддереву дочерних файлов и каталогов.

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

Спецификация
API «Файлы и каталоги» # api-directoryentry

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`FileSystemDirectoryEntry`	8	79	50	15	11.1	18	50	14	11.3	1.0	≤37
`createReader`	13	79	50	Нет	11.1	18	50	14	11.3	1.0	≤37
`getDirectory`	8	79	50 В Firefox параметр ввода `errorCallback` — это `DOMException`, а не `FileError` объект.	Нет	11.1	18	50 В Firefox для Android параметр ввода `errorCallback` — это `DOMException`, а не `FileError` объект.	14	11.3	1.0	≤37
`getFile`	8	79	50 В Firefox параметр ввода `errorCallback` — это `DOMException`, а не `FileError` объект.	Нет	11.1	18	50 В Firefox для Android параметр ввода `errorCallback` — это `DOMException`, а не `FileError` объект.	14	11.3	1.0	≤37
`removeRecursively`	8	79	50–52 Хотя метод `removeRecursively()` существовал, он немедленно вызывал обратный вызов ошибки с `NS_ERROR_DOM_SECURITY_ERR`.	Нет	Нет	18	50–52 Хотя метод `removeRecursively()` существовал, он немедленно вызывал обратный вызов ошибки с `NS_ERROR_DOM_SECURITY_ERR`.	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/FileSystemDirectoryEntry