在此页

• 基本概念
• 特性
• 方法
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

非标
此特征是非标准的，且不在标准轨道中。不要在面向 Web 的生产站点中使用它：它不适用于每个用户。实现之间可能存在大的不兼容性，且行为将来可能改变。

FileSystemEntry interface of the File and Directory Entries API represents a single in a file system. The entry can be a file or a directory (directories are represented by the DirectoryEntry interface). It includes methods for working with files—including copying, moving, removing, and reading files—as well as information about a file it points to—including the file name and its path from the root to the entry.

由于这是非标准 API，其规范目前不在标准轨道中，所以记住并非所有浏览器都有实现且可能仅实现一小部分，这点很重要。检查 浏览器兼容性 章节了解细节。

基本概念

不要创建 FileSystemEntry objects directly. Instead, you will receive an object based on this interface through other APIs. This interface serves as a base class for the FileSystemFileEntry and FileSystemDirectoryEntry interfaces, which provide features specific to file system entries representing files and directories, respectively.

FileSystemEntry interface includes methods that you would expect for manipulating files and directories, but it also includes a convenient method for obtaining the URL of the entry: toURL() . It also introduces a new URL scheme: filesystem: .

可以使用 filesystem: scheme on Google Chrome to see all the files and folders that are stored in the origin of your app. Just use filesystem: scheme for the root directory of the origin of the app. For example, if your app is in http://www.html5rocks.com , open filesystem: http://www.html5rocks.com/temporary/ in a tab. Chrome shows a read-only list of all the files and folders stored the origin of your app.

范例

To see an example of how toURL() works, see the method description . The snippet below shows you how you can remove a file by name.

// 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*/, function(fs) {
  fs.root.getFile('log.txt', {}, function(fileEntry) {
    fileEntry.remove(function() {
      console.log('File removed.');
    }, onError);
  }, onError);
}, onError);
					

特性

This interface provides the following properties.

filesystem 只读

FileSystem object representing the file system in which the entry is located.

fullPath 只读

USVString object which provides the full, absolute path from the file system's root to the entry; it can also be thought of as a path which is relative to the root directory, prepended with a "/" character.

isDirectory 只读

布尔 which is true if the entry represents a directory; otherwise, it's false .

isFile 只读

A Boolean which is true if the entry represents a file. If it's not a file, this value is false .

名称 只读

USVString containing the name of the entry (the final part of the path, after the last "/" character).

方法

This interface defines the following methods.

copyTo()

Copies the file or directory to a new location on the file system.

getMetadata()

Obtains metadata about the file, such as its modification date and size.

getParent()

返回 FileSystemDirectoryEntry representing the entry's parent directory.

moveTo()

Moves the file or directory to a new location on the file system, or renames the file or directory.

remove()

Removes the specified file or directory. You can only remove directories which are empty.

toURL()

Creates and returns a URL which identifies the entry. This URL uses the URL scheme "filesystem:" .

规范

规范	状态	注释
文件和目录条目 API	草案	提议 API 草案

此 API 没有正式的 W3C 或 WHATWG (Web 超文本应用程序技术工作组) 规范。

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
FileSystemEntry	Chrome 8 Alternate Name 8 Alternate Name Alternate Name Uses the non-standard name: Entry	Edge 79 Prefixed 79 Prefixed Prefixed Implemented with the vendor prefix: webkit	Firefox 50	IE 不支持 No	Opera 不支持 No	Safari 11.1	WebView Android ≤37 Alternate Name ≤37 Alternate Name Alternate Name Uses the non-standard name: Entry	Chrome Android 18 Alternate Name 18 Alternate Name Alternate Name Uses the non-standard name: Entry	Firefox Android 50	Opera Android 不支持 No	Safari iOS 11.3	Samsung Internet Android Yes Prefixed Yes Prefixed Prefixed Implemented with the vendor prefix: webkit
copyTo 弃用 非标	Chrome 8	Edge 79	Firefox 不支持 No	IE 不支持 No	Opera 不支持 No	Safari 不支持 No	WebView Android ≤37	Chrome Android 18	Firefox Android 不支持 No	Opera Android 不支持 No	Safari iOS 不支持 No	Samsung Internet Android Yes
filesystem	Chrome 8	Edge 79	Firefox 50	IE 不支持 No	Opera 不支持 No	Safari 11.1	WebView Android ≤37	Chrome Android 18	Firefox Android 50	Opera Android 不支持 No	Safari iOS 11.3	Samsung Internet Android Yes
fullPath	Chrome 8	Edge 79	Firefox 50	IE 不支持 No	Opera 不支持 No	Safari 11.1	WebView Android ≤37	Chrome Android 18	Firefox Android 50	Opera Android 不支持 No	Safari iOS 11.3	Samsung Internet Android Yes
getMetadata 弃用 非标	Chrome 8	Edge 79	Firefox 不支持 No	IE 不支持 No	Opera 不支持 No	Safari 不支持 No	WebView Android ≤37	Chrome Android 18	Firefox Android 不支持 No	Opera Android 不支持 No	Safari iOS 不支持 No	Samsung Internet Android Yes
getParent	Chrome 8	Edge 79	Firefox 不支持 No	IE 不支持 No	Opera 不支持 No	Safari 11.1	WebView Android ≤37	Chrome Android 18	Firefox Android 不支持 No	Opera Android 不支持 No	Safari iOS 11.3	Samsung Internet Android Yes
isDirectory	Chrome 8	Edge 79	Firefox 50	IE 不支持 No	Opera 不支持 No	Safari 11.1	WebView Android ≤37	Chrome Android 18	Firefox Android 50	Opera Android 不支持 No	Safari iOS 11.3	Samsung Internet Android Yes
isFile	Chrome 8	Edge 79	Firefox 50	IE 不支持 No	Opera 不支持 No	Safari 11.1	WebView Android ≤37	Chrome Android 18	Firefox Android 50	Opera Android 不支持 No	Safari iOS 11.3	Samsung Internet Android Yes
moveTo 弃用 非标	Chrome 8	Edge 79	Firefox 不支持 No	IE 不支持 No	Opera 不支持 No	Safari 不支持 No	WebView Android ≤37	Chrome Android 18	Firefox Android 不支持 No	Opera Android 不支持 No	Safari iOS 不支持 No	Samsung Internet Android Yes
名称	Chrome 8	Edge 79	Firefox 50	IE 不支持 No	Opera 不支持 No	Safari 11.1	WebView Android ≤37	Chrome Android 18	Firefox Android 50	Opera Android 不支持 No	Safari iOS 11.3	Samsung Internet Android Yes
remove 弃用 非标	Chrome 8	Edge 79	Firefox 不支持 No	IE 不支持 No	Opera 不支持 No	Safari 不支持 No	WebView Android ≤37	Chrome Android 18	Firefox Android 不支持 No	Opera Android 不支持 No	Safari iOS 不支持 No	Samsung Internet Android Yes
toURL 弃用 非标	Chrome 8	Edge 79	Firefox 不支持 No	IE 不支持 No	Opera 不支持 No	Safari 不支持 No	WebView Android ≤37	Chrome Android 18	Firefox Android 不支持 No	Opera Android 不支持 No	Safari iOS 不支持 No	Samsung Internet Android Yes

图例

完整支持

完整支持

不支持

不支持

实验。期望将来行为有所改变。

实验。期望将来行为有所改变。

非标。预期跨浏览器支持较差。

弃用。不要用于新网站。

弃用。不要用于新网站。

使用非标名称。

使用非标名称。

要求使用供应商前缀或不同名称。

要求使用供应商前缀或不同名称。

另请参阅

• 文件和目录条目 API
• 文件系统 API 介绍
• FileSystemFileEntry and FileSystemDirectoryEntry are based on FileSystemEntry .

元数据

• 最后修改： 2019 年 3 月 23 日

相关话题

1. 文件和目录条目 API
2. FileSystemEntry
3. 特性

   1. filesystem
   2. fullPath
   3. isDirectory
   4. isFile
   5. 名称
4. 方法

   1. copyTo()
   2. getMetadata()
   3. getParent()
   4. moveTo()
   5. remove()
   6. toURL()
5. 文件系统 API 相关页面

   1. FileError
   2. FileException
   3. FileHandle
   4. FileRequest
   5. FileSystem
   6. FileSystemDirectoryEntry
   7. FileSystemDirectoryEntrySync
   8. FileSystemDirectoryReader
   9. FileSystemDirectoryReaderSync
   10. FileSystemEntrySync
   11. FileSystemFileEntry
   12. FileSystemFileEntrySync
   13. FileSystemFlags
   14. FileSystemSync
   15. HTMLInputElement
   16. LocalFileSystem
   17. LocalFileSystemSync
   18. LockedFile
   19. 元数据
   20. Window.requestFileSystem()
   21. Window.resolveLocalFileSystemURL()
   22. WorkerGlobalScope.requestFileSystemSync()