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 FileSystemSync object represents a file system. It 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 specification is abandonned for the moment, failing to get significant traction.

Basic concepts

The FileSystemSync 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

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support13 webkit ? No No No No
name13 ? No No No No
root13 ? No No No No
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support Yes webkit Yes webkit ? No No No ?
name Yes Yes ? No No No ?
root Yes Yes ? No No No ?

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, Cobra, teoli, Sheppy, grendel
Last updated by: fscholz,