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.