filehandle.write(buffer, offset[, length[, position]])

• buffer <Buffer> | <TypedArray> | <DataView>
• offset <integer> 数据开始写入时在 buffer 中的起始位置。
• length <integer> 从 buffer 开始写入的字节数。默认值： buffer.byteLength - offset
• position <integer> | <null> 从文件开头开始偏移的位置，buffer 中的数据应写入该位置。如果 position 不是 number 类型，数据将写入当前的位置。详情参见 POSIX pwrite(2) 文档。默认值: null
• 返回：<Promise>

将 buffer 写入文件。

【Write buffer to the file.】

这个 promise 是通过一个包含两个属性的对象来实现的：

【The promise is fulfilled with an object containing two properties:】

• bytesWritten <integer> 写入的字节数
• buffer <Buffer> | <TypedArray> | <DataView> 对已写入 buffer 的引用。

在同一个文件上多次使用 filehandle.write() 是不安全的，如果不等待 Promise 被解决（或被拒绝）。对于这种情况，请使用 filehandle.createWriteStream()。

【It is unsafe to use filehandle.write() multiple times on the same file without waiting for the promise to be fulfilled (or rejected). For this scenario, use filehandle.createWriteStream().】

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

【On Linux, positional writes do not 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.】