API для файлов и каталогов

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

Получение доступа к файловой системе

Существует два способа получения доступа к файловым системам, определённым в текущем черновике спецификации:

При обработке события drop для перетаскивания, вы можете вызвать DataTransferItem.webkitGetAsEntry(), чтобы получить FileSystemEntry для перетащенного элемента. Если результат не null, то это перетащенный файл или каталог, и вы можете использовать вызовы файловой системы для работы с ним.
Свойство HTMLInputElement.webkitEntries позволяет получить доступ к объектам FileSystemFileEntry для выбранных файлов, но только если они были перетащены в окно выбора файлов. Если HTMLInputElement.webkitdirectory имеет значение true, элемент <input> вместо этого является выбором каталога, и вы получите объекты FileSystemDirectoryEntry для каждого выбранного каталога.

Интерфейсы

API для файлов и каталогов включает следующие интерфейсы:

FileSystem: Представляет файловую систему.
FileSystemEntry: Основной интерфейс, представляющий одну запись в файловой системе. Это реализуется другими интерфейсами, которые представляют файлы или каталоги.
FileSystemFileEntry: Представляет один файл в файловой системе.
FileSystemDirectoryEntry: Представляет один каталог в файловой системе.
FileSystemDirectoryReader: Созданный при вызове FileSystemDirectoryEntry.createReader(), этот интерфейс предоставляет функциональность для чтения содержимого каталога.

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

Спецификация
API для файлов и каталогов # api-domfilesystem

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`File_and_Directory_Entries_API`	7	≤18 До Edge 79, этот API поддерживался только в сценариях перетаскивания с использованием метода `DataTransferItem.webkitGetAsEntry()`. Он не был доступен для использования в панелях выбора файлов или папок (например, при использовании элемента `<input>` с атрибутом `HTMLInputElement.webkitdirectory`).	50	15	11.1	18	50	14	11.3	1.0	≤37
`name`	7	≤18	50	15	11.1	18	50	14	11.3	1.0	≤37
`root`	7	≤18	50	15	11.1	18	50	14	11.3	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/File_and_Directory_Entries_API