之前介绍了fs模块的文件可读流,本节继续介绍fs模块的文件可写流。
fs.WriteStream继承了stream.Writable,并重写了_write方法,实现了文件可写流
我们一般通过fs.createWriteStream来创建一个文件可写流对象。
目录
创建文件可写流对象
const fs = require('fs')
const path = require('path')
const ws = fs.createWriteStream(path.join(__dirname, 'test.txt'), {
fd: null,
flags: 'r+',
mode: 438,
encoding: 'utf-8',
start: 0,
autoClose: true,
highWaterMark: 2
})
fs.createWriteStream方法有两个参数,path和options
path就是要被写入数据的文件的路径
options就是可写流对象的一些参数
参数作用:
1、打开文件(打开文件,需要指定path或options.fd,options.flags,options.mode,options.encoding)
2、写入数据(写入数据的位置信息,从文件哪里开始start写入)
3、关闭文件(当写入完毕后,是否需要自动关闭文件autoClose)
还有可写流对象缓冲区的水位线highWaterMark
使用文件可写流对象
文件可写流的作用主要就是向文件中写入数据,写入数据的方式就是使用可写流的内置方法write和end。
其中write用于写入数据,end也可用于写入数据,但是其根本作用是通知可写流对象写入结束。
文件可写流的常用事件
open事件
创建可写流对象的同时就会打开文件,而打开文件就会触发可写流对象的open事件
监听open事件的主要作用就是获取文件描述符fd
error事件
当可写流对象创建或使用过程中发生任何异常时,都会触发error事件,我们一般监听error事件来处理异常情况
finish事件
当ws.end方法执行后,表示可写流对象停止写入了,此时表示写入结束,会触发finish事件
close事件
当可写流对象写入结束(即end方法执行),且autoClose为true时(即表示自动关闭文件时),就会触发close事件
end执行和autoClose为true,二者缺一都不会触发close事件
需要注意的是,我们无论是文件可写流的open事件,还是close事件,其实目标都不是文件本身,而是更多关注的是可写流对象。
即如果我们自己使用fs.close(fd)来关闭文件,无法触发文件可写流的close事件
drain事件
drain事件是可写流独有的事件,它的触发时机是,当可写流对象缓冲区数据量超过了highWaterMark水位线(state.needDrain被置为true),之后缓冲区数据被消费清空后,就会触发drain事件。
drain事件通常不会单独使用,通常是在生产者生产速度 快于 消费者消费速度时,作为报警器来提示生产者停止生产用的。
而drain事件正是协同生产速度和消费速度的背压机制的核心。
下面一节,我们来介绍背压机制。