File and Directory Entries API

文件与目录条目 API 模拟一个 web 应用可以导航和访问的本地文件系统。你在虚拟的沙箱文件系统中可以开发一个读、写、创建文件或者目录的应用。

根据您希望的是异步行为还是同步行为，存在两个非常相似的 API。同步 API 可在 Worker 中使用，并将返回所需的值。异步 API 不会阻塞和函数，API不会返回值;相反，您将需要提供一个回调函数，以便在响应到达时处理它。

有两种方法可以访问当前规范草案中定义的文件系统：

• 当处理用于拖放的 drop (en-US) 事件时，您可以调用 DataTransferItem.webkitGetAsEntry() 来为被删除的项获取FileSystemEntry。如果结果不是 null，那么它就是一个被删除的文件或目录，您可以使用文件系统调用来处理它。
• 属性允许您访问当前选定文件的 FileSystemFileEntry 对象，但前提是将它们拖放到文件选择器（bug 1326031）。如果htmlinputel.webkitdirectory为真，则 <input> 元素是一个目录选择器，您将为每个选择的目录获得 FileSystemDirectoryEntry 对象。

大多数操作都应该使用异步API，以防止在主线程上使用文件系统访问时阻塞整个浏览器。它包括以下接口:

FileSystem

表示文件系统。

FileSystemEntry

表示文件系统中单个条目的基本接口。这是由表示文件或目录的其他接口实现的。

FileSystemFileEntry

表示文件系统中的单个文件。

FileSystemDirectoryEntry

表示文件系统中的单个目录。

FileSystemDirectoryReader

该接口通过调用 FileSystemDirectoryEntry.createReader() (en-US) 创建，提供了允许读取目录内容的功能。

FileSystemFlags (en-US)

定义一组值，这些值用于在调用文件和目录API中的某些方法时指定选项标志。

FileError

表示由异步文件系统调用生成的错误。

还有两个全局函数（目前不属于规范的一部分，仅在 Google Chrome 中被实现）。它们在 Window 对象上可用，并在LocalFileSystem (en-US): requestFileSystem() 和 resolveLocalFileSystemURL() 中实现。

同步 API 应该只用于 Worker 中；在执行完毕前，这些调用会阻塞运行，并且只会简单地返回结果，而不是使用回调。在主线程上使用它们会阻塞整个浏览器，这很不明智。否则，下面的接口将镜像来自异步 API 的接口。

FileSystemSync

表示文件系统。

FileSystemEntrySync (en-US)

表示文件系统中单个条目的基本接口。这是由表示文件或目录的其他接口实现的。EntrySync (en-US)

FileSystemFileEntrySync

表示文件系统中的单个文件。

FileSystemDirectoryEntrySync

表示文件系统中的单个目录。

FileSystemDirectoryReaderSync

该接口通过调用 FileSystemDirectoryEntrySync.createReader() 创建，提供了允许读取目录内容的功能。

FileException

Represents an error which is generated by synchronous file system calls.

还有两个全局函数（目前不属于规范的一部分，仅在 Google Chrome 中被实现）。在 LocalFileSystemSync: requestFileSystemSync() 和 resolveLocalFileSystemSyncURL() 中实现。

LocalFileSystem (en-US)

使您能够访问沙盒文件系统。

LocalFileSystemSync

LockedFile

提供处理具有所有必要锁的给定文件的工具。

Metadata (en-US)

此 API 没有正式的 W3C 或 WHATWG 规范。

Firefox 50 中引入了对文件与目录条目 API 的部分支持。在使用各个接口和方法之前，一定要检查它们的兼容性表，确保它们得到支持。将 about:config 中的 dom.webkitBlink.filesystem 值设为 false 可禁用该 API。

• 介绍文件与目录条目 API
• Firefox 中支持的文件和目录 API 条目