NodeJS Stream（可读流、可写流） API解读

原文链接：https://juejin.im/post/5ba0d504e51d450ea13223ba
流的介绍
在 NodeJS 中，我们对文件的操作需要依赖核心模块 fs，fs 中有很基本 API 可以帮助我们读写占用内存较小的文件，如果是大文件或内存不确定也可以通过 open、read、write、close 等方法对文件进行操作，但是这样操作文件每一个步骤都要关心，非常繁琐，fs 中提供了可读流和可写流，让我们通过流来操作文件，方便我们对文件的读取和写入。

可读流
1、createReadStream 创建可读流
createReadStream 方法有两个参数，第一个参数是读取文件的路径，第二个参数为 options 选项，其中有八个参数：

flags：标识位，默认为 r；
encoding：字符编码，默认为 null；
fd：文件描述符，默认为 null；
mode：权限位，默认为 0o666；
autoClose：是否自动关闭文件，默认为 true；
start：读取文件的起始位置；
end：读取文件的（包含）结束位置；
highWaterMark：最大读取文件的字节数，默认 64 * 1024。
createReadStream 的返回值为 fs.ReadStream 对象，读取文件的数据在不指定 encoding 时，默认为 Buffer。

创建可读流
const fs = require(“fs”);

// 创建可读流，读取 1.txt 文件
let rs = fs.creatReadStream(“1.txt”, {
start: 0,
end: 3,
highWaterMark: 2
});复制代码
在创建可读流后默认是不会读取文件内容的，读取文件时，可读流有两种状态，暂停状态和流动状态。

注意：本篇的可写流为流动模式，流动模式中有暂停状态和流动状态，而不是暂停模式，暂停模式是另一种可读流 readable。
2、流动状态
流动状态的意思是，一旦开始读取文件，会按照 highWaterMark 的值一次一次读取，直到读完为止，就像一个打开的水龙头，水不断的流出，直到流干，需要通过监听 data 事件触发。

假如现在 1.txt 文件中的内容为 0~9 十个数字，我们现在创建可读流并用流动状态读取。

流动状态
const fs = require(“fs”);

let rs = fs.createReadStream(“1.txt”, {
start: 0,
end: 3,
highWaterMark: 2
});

// 读取文件
rs.on(“data”, data => {
console.log(data);
});

// 监听读取结束
rs.on(“end”, () => {
console.log(“读完了”);
});

// <Buffer 30 31>
// <Buffer 32 33>
// 读完了复制代码
在上面代码中，返回的 rs 对象监听了两个事件：

data：每次读取 highWaterMark 个字节，触发一次 data 事件，直到读取完成，回调的参数为每次读取的 B