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 filesystem you need to invoke the user by eg. installing a Chrome extension. The relevant Chrome API can be found here.

Basic concepts

There are two ways to get access to a FileSystem object:

1. 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 a FileSystem object describing the file system.
2. You can get it from a file system entry object, through its filesystem property.

Properties

FileSystem.name Read only

A USVString representing the file system's name. This name is unique among the entire list of exposed file systems.

FileSystem.root Read only

A FileSystemDirectoryEntry object 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

Browser compatibility

See also

• File and Directory Entries API
• Introduction to the File System API
• FileSystemEntry, FileSystemFileEntry, and FileSystemDirectoryEntry
• MSDN article: WebKitFileSystem object