/Web APIs


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 IDBMutableFile interface provides access in read or write mode to a file, dealing with all the necessary locks.

Note: This interface used to be called FileHandle , but it was changed to this (bug 1006485.)

As IDBMutableFile objects are bound to a fake file system built on top of IndexedDB, such an object is created using the IDBDatabase.createMutableFile method.


MutableFile.name Read only

The name of the handled file.

MutableFile.type Read only

The MIME type of the handled file.

Events Handler


The abort event is triggered each time the handled file is aborted.


The error event is triggered each time something goes wrong.



Returns a LockedFile object to read or write the associated file safely.


Returns a DOMRequest object. In case of success, the request's result is a File object representing a snapshot of the handled file.


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

See also

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.