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

版本历史

版本	变更
v18.0.0	将无效回调传给 `callback` 参数现在会抛出 `ERR_INVALID_ARG_TYPE` 而不是 `ERR_INVALID_CALLBACK`。
v14.0.0	参数 `buffer` 不会再将不支持的输入强制转换为字符串。
v10.10.0	参数 `buffer` 现在可以是任何 `TypedArray` 或 `DataView`。
v10.0.0	参数 `callback` 不再是可选的。不传入它会在运行时抛出 `TypeError`。
v7.4.0	参数 `buffer` 现在可以是 `Uint8Array`。
v7.2.0	参数 `offset` 和 `length` 现在是可选的。
v7.0.0	参数 `callback` 不再是可选的。不传入它将触发 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 指定的文件。

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

position 指从文件开头数据应被写入的偏移量。如果 typeof position !== 'number'，则数据将写入当前位置。参见 pwrite(2)。

回调将提供三个参数 (err, bytesWritten, buffer)，其中 bytesWritten 指定从 buffer 写入的字节数。

如果此方法作为其 util.promisify() 版本被调用，则返回具有 bytesWritten 和 buffer 属性的 Object 的 promise。

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

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

History

Version	Changes
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	Added in: v0.0.2

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

Write buffer to the file specified by fd.

offset determines the part of the buffer to be written, and length is an integer specifying the number of bytes to write.

position refers to the offset from the beginning of the file where this data should be written. If typeof position !== 'number', the data will be written at the current position. See pwrite(2).

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

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

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.

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.