Node.js_流Stream

Node.js 中的流(Streams)是一种处理读取和写入数据的抽象接口,它允许你以非阻塞的方式处理数据,这对于处理大文件或网络请求等 I/O 密集型任务非常有用。流主要分为四种类型:可读流(Readable)、可写流(Writable)、双工流(Duplex)和转换流(Transform)。

1. 可读流(Readable Streams)

可读流用于从源读取数据。数据源可以是文件、网络连接等。

常用函数:
  • read([size]):从流中读取数据。不推荐直接使用,因为流的设计初衷是自动处理数据的流动。
  • pipe(destination[, options]):将可读流的数据流重定向到一个可写流。这是处理流数据最常见的方法之一。
  • pause():暂停流中的数据读取。
  • resume():恢复流的数据读取。
  • on('data', callback):当流中有数据可读时,触发回调函数。
  • on('end', callback):当没有更多数据可读时触发。
  • on('error', callback):处理流中的错误。

2. 可写流(Writable Streams)

可写流用于将数据写入目标。目标可以是文件、网络连接等。

常用函数:
  • write(chunk[, encoding][, callback]):向流中写入数据。chunk 是要写入的数据,encoding 是数据的编码(如果 chunk 是字符串),callback 是写入完成后的回调函数。
  • end([chunk][, encoding][, callback]):结束写入过程。可选的 chunk 和 encoding 允许在结束前再写入一些数据。
  • on('drain', callback):当可以继续写入数据时被调用(即流内部的缓冲区为空时)。
  • on('finish', callback):当所有数据都被写入底层系统时触发。
  • on('error', callback):处理流中的错误。

3. 双工流(Duplex Streams)

双工流既是可读流也是可写流。例如,TCP 套接字连接。

继承自可读流和可写流的属性和方法。

4. 转换流(Transform Streams)

转换流是特殊的双工流,其输出数据是基于输入数据的某种转换。例如,zlib.createGzip() 用于创建 gzip 压缩流。

常用函数(继承自双工流):
  • _transform(chunk, encoding, callback):这是转换流的核心方法,需要被重写以实现自定义的转换逻辑。chunk 是要转换的数据块,encoding 是数据的编码(如果 chunk 是字符串),callback 是转换完成后的回调函数。

    const fs = require('fs');
    const readableStream = fs.createReadStream('input.txt');
    const writableStream = fs.createWriteStream('output.txt');

    readableStream.pipe(writableStream);

    readableStream.on('end', () => {
    console.log('文件读取完毕');
    });

    writableStream.on('finish', () => {
    console.log('文件写入完毕');
    });

在这个例子中,我们使用 fs.createReadStream 创建一个可读流来读取 input.txt 文件,然后使用 fs.createWriteStream 创建一个可写流来写入 output.txt 文件。通过 pipe 方法,我们实现了从可读流到可写流的数据流重定向。当可读流结束(end 事件)时,表示文件已读取完毕;当可写流完成写入(finish 事件)时,表示数据已完全写入目标文件。

相关推荐
tryCbest1 小时前
Vue3——第 22 篇:Pinia——新一代状态管理(上)
前端·javascript·vue.js
bai2731 小时前
"👨‍👩‍👧‍👦" 的 length 是 11:我把自己写的字数统计脚本拖出来审了一遍
前端·javascript
张张123y2 小时前
个人助手型 Agent 的六个工程细节:Hermes 与 OpenClaw 的审批、委派、上下文与调度
网络·人工智能·开源·后端开发·ai agent
zhanlang02173 小时前
HTML 零基础入门到企业实战【第八章 8.5】画布 canvas、SVG 矢量图形基础入门
前端·html
nice_lcj5203 小时前
【从零理解计算机网络 · 15】完整串联:一次请求的全旅程,以及那道经典面试题
网络·计算机网络·http·面试·tcp·总结·网络排查
星云_byto3 小时前
CSS面试题
前端·css
zhanlang02174 小时前
HTML 零基础入门到企业实战全套教程【连载 8.4】HTML5 新增表单属性与表单控件
前端·html·html5
科研邪修法12 小时前
PDF新增页面文字与文本批注怎么区分?以双版本培训讲义为例
前端·css·pdf
Lanwarf-前端开发13 小时前
Vue3 + Canvas/WebGL 雷达扫描可视化实战:PPI、RHI、VOL、SVOL 四种模式原理与实现
前端·javascript·vue.js·webgl
FRing0314 小时前
vue3干货总结2(vue3生命周期、父子通信、模版引用、provide和inject)
开发语言·前端·vue.js·vue3