FileSystem
The File and Directory Entries API interface FileSystem is used to represent a file system. These objects can be obtained from the filesystem property on any file system entry. Some browsers offer additional APIs to create and manage file systems, such as Chrome's requestFileSystem() method.
This interface will not grant you access to the users' filesystem. Instead, you will have a "virtual drive" within the browser sandbox if you want to gain access to the users' file system, you need to invoke the user, for example by installing a Chrome extension. The relevant Chrome API can be found in the Chrome developer docs.
Basic concepts
There are two ways to get access to a FileSystem object:
- You can directly ask for one representing a sandboxed file system created just for your web app directly by calling
window.requestFileSystem(). If that call is successful, it executes a callback handler, which receives as a parameter aFileSystemobject describing the file system. - You can get it from a file system entry object, through its
filesystemproperty.
Instance properties
FileSystem.nameRead only-
A string representing the file system's name. This name is unique among the entire list of exposed file systems.
FileSystem.rootRead only-
A
FileSystemDirectoryEntryobject which represents the file system's root directory. Through this object, you can gain access to all files and directories in the file system.
Specifications
| Specification |
|---|
| File and Directory Entries API # api-domfilesystem |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
FileSystem
|
|
|
|
|
|
|
|
|
|
|
|
|
name
|
|
|
|
|
|
|
|
|
|
|
|
|
root
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- See implementation notes.