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]):结束写入过程。可选的 chunkencoding 允许在结束前再写入一些数据。
  • 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 事件)时,表示数据已完全写入目标文件。

相关推荐
寻星探路9 小时前
【深度长文】万字攻克网络原理:从 HTTP 报文解构到 HTTPS 终极加密逻辑
java·开发语言·网络·python·http·ai·https
崔庆才丨静觅11 小时前
hCaptcha 验证码图像识别 API 对接教程
前端
passerby606112 小时前
完成前端时间处理的另一块版图
前端·github·web components
掘了12 小时前
「2025 年终总结」在所有失去的人中,我最怀念我自己
前端·后端·年终总结
崔庆才丨静觅12 小时前
实用免费的 Short URL 短链接 API 对接说明
前端
崔庆才丨静觅12 小时前
5分钟快速搭建 AI 平台并用它赚钱!
前端
盟接之桥13 小时前
盟接之桥说制造:引流品 × 利润品,全球电商平台高效产品组合策略(供讨论)
大数据·linux·服务器·网络·人工智能·制造
崔庆才丨静觅13 小时前
比官方便宜一半以上!Midjourney API 申请及使用
前端
Moment13 小时前
富文本编辑器在 AI 时代为什么这么受欢迎
前端·javascript·后端
崔庆才丨静觅13 小时前
刷屏全网的“nano-banana”API接入指南!0.1元/张量产高清创意图,开发者必藏
前端