This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.

In the File System API, a FileSystem object represents a file system. The object is the argument of a successful callback of requestFileSystem(). The FileSystem object has two properties.

About this document

This document was last updated on March 2, 2012 and follows the W3C Specifications (Working Draft) drafted on April 19, 2011.
The draft is no more actively maintained, the specification is abandonned for the moment as it didn't get any significant traction.

Basic concepts

You request access to a sandboxed file system by calling window.requestFileSystem(). CallingrequestFileSystem()creates new storage for your web app.The argument of the a successful callback is the FileSystem object, which has two properties: the name and root of the file system.

The FileSystem object is your gateway to the entire API and you will use it a lot. So once you have a reference, cache the object in a global variable or class property.


Attribute Type Description
name readonly DOMString Name of the file system. The name must be unique across the list of exposed file systems.
root readonly DirectoryEntry The root directory of the file system.

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 13webkit Not supported Not supported Not supported Not supported
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support Not supported 0.16webkit Not supported Not supported Not supported Not supported

See also

Specification:File API: Directories and System SpecificationWD

Reference: File System API

Introduction: Basic Concepts About the File System API

Document Tags and Contributors

Contributors to this page: fscholz, Reachmeatshivam, Cobra, XeXenon, teoli, Sheppy, grendel
Last updated by: fscholz,