Window.requestFileSystem()

Non-standard
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.

The non-standard Window method requestFileSystem() method is a Google Chrome-specific method which lets a web site or app gain access to a sandboxed file system for its own use. The returned FileSystem is then available for use with the other file system APIs.

Even compared to the rest of the File and Directory Entries API, requestFileSystem() is especially non-standard; only Chrome implements it, and all other browser makers have decided that they will not implement it. It has even been removed from the proposed specification. Do not use this method!

Syntax

This method is prefixed with webkit in all browsers that implement it (that is, Google Chrome).

window.requestFileSystem(type, size, successCallback[, errorCallback]);

Parameters

type
The type of storage to request. Specify Window.TEMPORARY if it's acceptable for the browser to delete the files at its own discretion, such as if storage space runs low, or Window.PERSISTENT if you need the files to remain in place unless the user or the web site or app explicitly permit it. Persistent storage requires that the user grant the site quota.
size
The amount of storage space you wish to have allocated for your app's use.
successCallback
A function which is invoked when the file system has been successfully obtained. The callback receives a single parameter: a FileSystem object representing the file system the app has permission to use.
errorCallback Optional
An optional parameter specifying a function which is called if an error occurs while attempting to obtain the file system, or if the user denies permission to create or access the file system. The callback receives as input a single parameter: a FileError object describing the error.

Return value

undefined

Example

Specifications

Specification Status Comment
File and Directory Entries API Draft Draft of proposed API

This API has no official W3C or WHATWG specification.

Browser compatibility

DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
requestFileSystem
ExperimentalNon-standard
Chrome Full support 13
Prefixed
Full support 13
Prefixed
Prefixed Implemented with the vendor prefix: webkit
Edge Full support ≤18
Prefixed
Full support ≤18
Prefixed
Prefixed Implemented with the vendor prefix: webkit
Firefox No support NoIE No support NoOpera No support NoSafari No support NoWebView Android Full support 37
Prefixed
Full support 37
Prefixed
Prefixed Implemented with the vendor prefix: webkit
Chrome Android Full support Yes
Prefixed
Full support Yes
Prefixed
Prefixed Implemented with the vendor prefix: webkit
Firefox Android No support NoOpera Android No support NoSafari iOS No support NoSamsung Internet Android Full support Yes
Prefixed
Full support Yes
Prefixed
Prefixed Implemented with the vendor prefix: webkit

Legend

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.
Experimental. Expect behavior to change in the future.
Non-standard. Expect poor cross-browser support.
Non-standard. Expect poor cross-browser support.
Requires a vendor prefix or different name for use.
Requires a vendor prefix or different name for use.

See also