Protected Optional_Protected_ProtectedclosedWhether the file is open or closed
ProtectedcontextProtecteddirtyWhether the file has changes which have not been written to the FS
ReadonlyfdReadonlyflagThe flag the handle was opened with
Protected ReadonlyfsThe internal FS associated with the handle
ReadonlyinodeStats for the handle
ReadonlyinternalThe path relative to the FileSystem's root
ReadonlypathThe path relative to the context's root
Get the current file position.
We emulate the following bug mentioned in the Node documentation:
On Linux, positional writes don't work when the file is opened in append mode. The kernel ignores the position argument and always appends the data to the end of the file.
The current file position.
Protected_Read data from the file.
The buffer that the data will be written to.
The offset within the buffer where writing will start.
An integer specifying the number of bytes to read.
An integer specifying where to begin reading from in the file. If position is unset, data will be read from the current file position.
Protected_Write buffer to the file.
Uint8Array containing the data to write to the file.
Offset in the buffer to start reading data from.
The amount of bytes to write to the file.
Offset from the beginning of the file where this data should be written. If position is null, the data will be written at the current position.
Asynchronously append data to a file, creating the file if it does not exist. The underlying file will not be closed automatically.
The FileHandle must have been opened for appending.
The data to write. If something other than a Buffer or Uint8Array is provided, the value is coerced to a string.
Either the encoding for the file, or an object optionally specifying the encoding, file mode, and flag.
encoding defaults to 'utf8'.mode defaults to 0o666.flag defaults to 'a'.Asynchronous fchmod(2) - Change permissions of a file.
A file mode. If a string is passed, it is parsed as an octal integer.
Asynchronous fchown(2) - Change ownership of a file.
Asynchronous close(2) - close a FileHandle.
Creates a stream for reading from the file.
Options for the readable stream
Creates a stream for writing to the file.
Options for the writeable stream.
Asynchronous fdatasync(2) - synchronize a file's in-core state with storage device.
ProtecteddisposeCleans up. This will not sync the file data to the FS
Optionalforce: booleanAsynchronously reads data from the file.
The FileHandle must have been opened for reading.
The buffer that the data will be written to.
Optionaloffset: numberThe offset in the buffer at which to start writing.
Optionallength: numberThe number of bytes to read.
Optionalposition: null | numberThe offset from the beginning of the file from which data should be read. If null, data will be read from the current position.
Asynchronously reads data from the file.
The FileHandle must have been opened for reading.
Read file data using a ReadableStream.
The handle will not be closed automatically.
Asynchronously reads the entire contents of a file.
If options is a string, then it specifies the encoding.
The FileHandle has to support reading.
If one or more filehandle.read() calls are made on a file handle and then a filehandle.readFile() call is made, the data will be read from the current
position till the end of the file. It doesn't always read from the beginning
of the file.
Optionaloptions: null | { encoding?: null } & AbortableFulfills upon a successful read with the contents of the file. If no encoding is specified (using options.encoding), the data is returned as a {Buffer} object. Otherwise, the
data will be a string.
Asynchronously reads the entire contents of a file. The underlying file will not be closed automatically.
The FileHandle must have been opened for reading.
Asynchronously reads the entire contents of a file. The underlying file will not be closed automatically.
The FileHandle must have been opened for reading.
Optional_options: null | BufferEncoding | ObjectEncodingOptions & AbortableCreates a readline Interface object that allows reading the file line by line
Optionaloptions: CreateReadStreamOptionsOptions for creating a read stream
A readline interface for reading the file line by line
Asynchronous readv. Reads into multiple buffers.
An array of Uint8Array buffers.
Optionalposition: numberThe position in the file where to begin reading.
The number of bytes read.
Asynchronous fstat(2) - Get file status.
Optionalopts: StatOptions & { bigint?: false }Asynchronous fsync(2) - synchronize a file's in-core state with the underlying storage device.
Asynchronous ftruncate(2) - Truncate a file to a specified length.
If not specified, defaults to 0.
Asynchronously change file timestamps of the file.
The last access time. If a string is provided, it will be coerced to number.
The last modified time. If a string is provided, it will be coerced to number.
InternalNot part of the Node.js API!
Write file data using a WritableStream.
The handle will not be closed automatically.
Asynchronously writes string to the file.
The FileHandle must have been opened for writing.
It is unsafe to call write() multiple times on the same file without waiting for the Promise
to be resolved (or rejected). For this scenario, createWriteStream is strongly recommended.
Optionaloptions: null | number | { length?: number; offset?: number; position?: number }OptionallenOrEnc: null | number | BufferEncodingOptionalposition: null | numberAsynchronously writes data to a file, replacing the file if it already exists. The underlying file will not be closed automatically.
The FileHandle must have been opened for writing.
It is unsafe to call writeFile() multiple times on the same file without waiting for the Promise to be resolved (or rejected).
The data to write. If something other than a Buffer or Uint8Array is provided, the value is coerced to a string.
Either the encoding for the file, or an object optionally specifying the encoding, file mode, and flag.
encoding defaults to 'utf8'.mode defaults to 0o666.flag defaults to 'w'.Asynchronous writev. Writes from multiple buffers.
An array of Uint8Array buffers.
Optionalposition: numberThe position in the file where to begin writing.
The number of bytes written.
Current position