filehandle.writeFile(data, options)

• data <string> | <Buffer> | <TypedArray> | <DataView> | <AsyncIterable> | <Iterable> | <Stream>

• options <Object> | <string>

  • encoding <string> | <null> 当 data 为字符串时的预期字符编码。默认值：'utf8'

    ¥encoding <string> | <null> The expected character encoding when data is a string. Default: 'utf8'

• 返回：<Promise>

  ¥Returns: <Promise>

异步地将数据写入文件，如果文件已经存在，则替换该文件。data 可以是字符串、缓冲区、<AsyncIterable>、或 <Iterable> 对象。诺言一经成功就兑现了，没有任何争议。

¥Asynchronously writes data to a file, replacing the file if it already exists. data can be a string, a buffer, an <AsyncIterable>, or an <Iterable> object. The promise is fulfilled with no arguments upon success.

如果 options 是字符串，则它指定 encoding。

¥If options is a string, then it specifies the encoding.

<FileHandle> 必须支持写入。

¥The <FileHandle> has to support writing.

在同一个文件上多次使用 filehandle.writeFile() 而不等待 promise 被履行（或拒绝）是不安全的。

¥It is unsafe to use filehandle.writeFile() multiple times on the same file without waiting for the promise to be fulfilled (or rejected).

如果在文件句柄上进行了一次或多次 filehandle.write() 调用，然后进行 filehandle.writeFile() 调用，则数据将从当前位置写入，直到文件末尾。它并不总是从文件的开头写入。

¥If one or more filehandle.write() calls are made on a file handle and then a filehandle.writeFile() call is made, the data will be written from the current position till the end of the file. It doesn't always write from the beginning of the file.