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 getMetadata() method of the IDBFileHandle allows retrieving some metadata about the file.




options Optional

An object used to request specific metadata. Each key is a boolean where true means the metadata is expected and where false means it is not expected. Note that if the key is undefined, it is considered as if it were true.

The following metadata are supported:


The size of the file.


The Date when the file was last modified.

Return value

An IDBFileRequest object. In case of success, the request's result is an object with the metadata requested through the param object.


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

Browser compatibility

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

See also