Node.js fs.createWriteStream() 方法

在Node.js中，fs模块提供了多种文件操作的API，其中，fs.createWriteStream()方法可以用于创建可写流到指定文件路径，从而向指定文件中写入数据。

语法

fs.createWriteStream(path[, options])

参数说明：

• path：字符串，表示文件路径。

• options：可选对象，表示写入流的一些配置选项。常用的选项包括：

  • flags：字符串，表示文件操作模式，默认值为 'w'。
  • encoding：字符串，表示文件编码，默认值为 'utf8'。
  • mode：整数，表示文件权限，默认值为 0o666。
  • autoClose：布尔值，表示是否在写入完成后自动关闭文件，默认为 true。
  • start：整数，表示写入文件时的起始偏移量。
  • end：整数，表示写入文件时的结束偏移量。

示例

下面的例子演示了如何使用fs.createWriteStream()方法将数据写入指定文件中：

const fs = require('fs');

const writeStream = fs.createWriteStream('./output.txt', {
  flags: 'a', // 追加模式
  encoding: 'utf8', // 编码方式
});

writeStream.write('Hello World!\n');
writeStream.write('Learn Node.js.\n');

// 结束写入
writeStream.end(() => {
  console.log('数据已经被写入文件。');
});

在以上示例中，我们首先引入了Node.js的fs模块，然后使用fs.createWriteStream()方法创建了一个可写流，并指定了要写入的文件路径为 './output.txt'，同时使用了一些配置选项，使得写入操作以追加模式且使用 UTF-8 编码进行。接着，我们使用 writeStream.write() 方法向可写流中写入数据；最后，我们使用 writeStream.end() 方法来结束写入操作。在结束回调函数中，我们输出了一条信息，表示数据已经被成功写入指定文件中。

小结

通过以上介绍，我们可以看到，使用 fs.createWriteStream() 方法向文件中写入数据是非常容易的。如果需要进行更多细节的控制，我们还可以通过一些可选的配置选项进行定制化设置。这些API的灵活性和易用性也是Node.js作为服务器端开发语言受欢迎的一大原因之一。