【第2章 Node.js基础】2.7 Node.js 的流(一)可写流
🌈可写流
🚀什么是可写流
可写流是对数据被写入的目的地的一种抽象。
所有可写流都实现了 stream.Writable类定义的接口。
可写流的例子包括，也都是实现了可写流接口的双工流
- 客户端的 HTTP 请求、
- 服务器的HTTP 响应、
- fs 的写入流、
- zlib 流、
- crypto 流、
- TCP Socket、
- 子进程 stdin、
- process.stdout、
- process.stderr等。
尽管可写流的具体实例可能略有差别，但所有可写流都遵循同一基本的使用模式，下面用一个示例解释这种模式:
const myStream = getWritableStreamSomehow();
myStream.write('一些数据');
myStream.write('更多数据');
myStream.end('完成写入数据');
stream.Writable 类定义的主要事件如下。
close:当流或其底层资源被关闭时被触发。不是所有可写流都会触发该事件。drain: 如果调用stream.write(chunk)方法返回 false，则当可以继续写入数据到流时会触发该
事件。error: 写入数据发生错误时被触发。当触发该事件时，流还未被关闭。finish: 调用stream.end()方法且缓冲数据都已传给底层系统之后被触发pipe:当在可读流上调用stream.pipe()方法时被触发。unpipe:当在可读流上调用stream.unpipe()方法时被触发。当可读流通过管道流向可写流发生错误时，也会触发该事件。
🐯案例：fs 的写入流
const fs = require("fs");
let writeStream = fs.createWriteStream("outpuut.txt");
let str = "爱上一个不回家的人";
writeStream.write(str,'UTF8');
writeStream.end();
writeStream.on('finish',()=>{
console.log("写入完成");
})
writeStream.on('error',(error)=>{
console.log("写入失败:",error);
})
⭐️动图演示
🐯案例：process.stdout
进程 I/O 同样也是 Writable 和 EventEmitter 的实例，耳听为虚眼见为实，请同学们可以打印：
const stream = require("stream");
const events = require("events");
console.log(process.stdout instanceof stream.Writable); // true
console.log(process.stdout instanceof events.EventEmitter); // true
process.stdout.write('你好!');
process.stderr.write('报错了啦')
在 node.js 中 console.log 内部就是由 process.stdout 实现的。对应 console.error 内部就是由 process.stderr 实现的。（没错 process.stderr 也是可写流）。
⭐️输出
$ node .\process-写入流.js
你好!报错了啦