IDBFileHandle
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 IDBFileHandle
interface provides tools to deal with a given file with all the necessary locks.
Instance properties
IDBFileHandle.fileHandle
Read only-
The
IDBMutableFile
object from which the lock was opened. IDBFileHandle.mode
Read only-
The mode for accessing the file; can be
readonly
orreadwrite
. IDBFileHandle.active
Read only-
A flag indicating if the file can be accessed (
true
) or not (false
). IDBFileHandle.location
-
The position of the reading/writing pointer within the file.
Instance methods
IDBFileHandle.getMetadata()
-
Allows to retrieve the file metadata (size and date of the last modification).
IDBFileHandle.readAsArrayBuffer()
-
Allows to retrieve a part of the content of the file as an
ArrayBuffer
. IDBFileHandle.readAsText()
-
Allows to retrieve a part of the content of the file as a string.
IDBFileHandle.write()
-
Allows to write some data in the file starting at the
location
offset. IDBFileHandle.append()
-
Allows to write some data at the end of the file..
IDBFileHandle.truncate()
-
Allows to truncate the file's content.
IDBFileHandle.flush()
-
Allows to guarantee that any buffered data has been transferred to disk.
IDBFileHandle.abort()
-
Makes the
IDBFileHandle
inactive and cancels all ongoing operations.
Events Handler
Specifications
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
.