Deprecated: This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.

Note: The three non-standard interfaces IDBMutableFile, IDBFileHandle, and IDBFileRequest are disabled by default. Consider using the File and Directory Entries API instead.

The IDBFileRequest interface provides some extra properties necessary for the IDBFileHandle objects.

Instance properties

IDBFileRequest also inherits properties from the EventTarget interface as well as the then() method from the defunct DOMRequest interface described below.

IDBFileRequest.lockedFile Read only

The IDBMutableFile object from which the request was started.

Instance methods


Returns a DOMRequest and takes two callback functions, one for its success and one for its failure cases, as parameters.



Fired periodically while the operation is in progress.


This feature is not part of any current specification. It is no longer on track to become a standard.

Browser compatibility

This interface is not supported by any current browser. From Firefox 102 it is behind the preference dom.fileHandle.enabled.

See also