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 LocalFileSystemSync
interface of the File System API gives you access to a sandboxed file system. It is intended to be used with WebWorkers. The methods are implemented by worker objects.
This document was last updated on March 2, 2012 and follows the W3C Specifications (Working Draft) drafted on April 19, 2011.
This specification is more or less abandoned, failing to get significant traction.
You can request access to a sandboxed file system by requesting LocalFileSystemSync
object from within a web worker. The global methods in the window
object requestFileSystemSync()
and resolveLocalFileSystemSyncURL()
methods are exposed to the Worker's global scope. Calling window.requestFileSystemSync()
for creates new storage for your web app.
For more concepts, see the counterpart article for the asynchronous API.
window.requestFileSystemSync = window.requestFileSystemSync || window.webkitRequestFileSystemSync;
var fs = requestFileSystemSync(TEMPORARY, 1024*1024 );
Because you are using a synchronous API, you don't need success and error callbacks.
Requests a file system where data should be stored. You access a sandboxed file system by requesting a LocalFileSystemSync
object from within a web worker using this global method, window.requestFileSystemSync()
. [ RESEARCH ]
FileSystemSync requestFileSystemSync(
in unsigned short type,
in unsigned long long size
);
Parameters
-
type
-
The storage type of the file system. The values can be either TEMPORARY
or PERSISTENT
.
-
size
-
The storage space—in bytes—that you need for your app.
Returns
-
FileSystemSync
-
An object that represents the file system.
Exceptions
This method can raise an FileException with the following code:
Allows the user to look up the Entry
for a file or directory referred to by a local URL.
void resolveLocalFileSystemURL(
in DOMString url
);
Parameter
-
url
-
The URL of a local file in the file system.
Returns
-
EntrySync
-
An object that represents entries in the file system.
Exceptions
This method can raise a FileException with the following codes: