fs.write(fd, buffer, offset[, length[, position]], callback)

版本历史

版本	变更
v18.0.0	Passing an invalid callback to the `callback` argument now throws `ERR_INVALID_ARG_TYPE` instead of `ERR_INVALID_CALLBACK`.
v14.0.0	The `buffer` parameter won't coerce unsupported input to strings anymore.
v10.10.0	The `buffer` parameter can now be any `TypedArray` or a `DataView`.
v10.0.0	The `callback` parameter is no longer optional. Not passing it will throw a `TypeError` at runtime.
v7.4.0	The `buffer` parameter can now be a `Uint8Array`.
v7.2.0	The `offset` and `length` parameters are optional now.
v7.0.0	The `callback` parameter is no longer optional. Not passing it will emit a deprecation warning with id DEP0013.
v0.0.2	新增于: v0.0.2

fd <integer>
buffer <Buffer> | <TypedArray> | <DataView>
offset <integer> 默认值： 0
length <integer> 默认值: buffer.byteLength - offset
position <integer> | <null> 默认值： null
callback <Function>
- err <Error>
- bytesWritten <integer>
- buffer <Buffer> | <TypedArray> | <DataView>

将 buffer 写入由 fd 指定的文件。

🌐 Write buffer to the file specified by fd.

offset 决定要写入缓冲区的部分，而 length 是指定要写入字节数的整数。

position 指的是应将此数据写入文件起始位置的偏移量。如果 typeof position !== 'number'，数据将写入当前位置。参见 pwrite(2)。

回调函数将接收三个参数 (err, bytesWritten, buffer)，其中 bytesWritten 指定了从 buffer 写入了多少字节。

🌐 The callback will be given three arguments (err, bytesWritten, buffer) where bytesWritten specifies how many bytes were written from buffer.

如果以其 util.promisify()ed 版本调用此方法，它会返回一个包含 bytesWritten 和 buffer 属性的 Object 的 Promise。

🌐 If this method is invoked as its util.promisify()ed version, it returns a promise for an Object with bytesWritten and buffer properties.

在同一个文件上多次使用 fs.write() 而不等待回调是不安全的。对于这种情况，建议使用 fs.createWriteStream()。

🌐 It is unsafe to use fs.write() multiple times on the same file without waiting for the callback. For this scenario, fs.createWriteStream() is recommended.

在 Linux 上，当文件以追加模式打开时，位置写入不起作用。内核会忽略位置参数，并始终将数据追加到文件末尾。

🌐 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.