FileEntrySync

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 FileEntrySync interface of the File System API represents a file in a file system. It lets you write content to a file.

Inherits from: EntrySync

About this document

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 as it didn't get significant traction among browser makers.

Basic concepts

To write content to file, create a FileWriter object by calling createWriter().

Method overview

FileWriterSync createWriter () raises (FileException);
File file () raises (FileException);

Methods

createWriter()

Creates a new FileWriter associated with the file that the FileEntry represents.

void createWriter (
) raises (FileException);
Parameter

None.

Returns
FileWriterSync
Exceptions

This method can raise a FileException with the following codes:

Exception Description
NOT_FOUND_ERR The file does not exist.
INVALID_STATE_ERR The file is no longer valid for some reason other than it having been deleted.

file()

Returns a File that represents the current state of the file that this FileEntry represents.

void file (
) raises (FileException);
Parameter

None.

Returns
File
Exceptions

This method can raise a FileException with the following codes:

Exception Description
NOT_FOUND_ERR The file does not exist.
INVALID_STATE_ERR The file is no longer valid for some reason other than it having been deleted.

Browser compatibility

DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
FileEntrySync
Non-standard
Chrome Full support 13
Prefixed
Full support 13
Prefixed
Prefixed Implemented with the vendor prefix: webkit
Edge Full support ≤79
Prefixed
Full support ≤79
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 18
Prefixed
Full support 18
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 1.0
Prefixed
Full support 1.0
Prefixed
Prefixed Implemented with the vendor prefix: webkit

Legend

Full support
Full support
No support
No support
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

Specification:File API: Directories and System SpecificationWD

Reference: File System API

Introduction: Introduction to the File and Directory Entries API