Node.js 的流處理是處理大數據和 I/O 密集型任務的核心能力。2026 年的 Node.js 22 帶來了流 API 的重要更新,包括 Web Streams API 的完全支持、新的流組合器和改進的背壓處理。
Web Streams API vs Stream 模塊
Node.js 22 同時支持兩種流 API:
javascript
// 傳統 Node.js Stream
const { Readable, Transform } = require('node:stream');
// Web Streams API(瀏覽器兼容)
const { ReadableStream, TransformStream } = require('node:stream/web');
Web Streams 的優勢:
- 瀏覽器兼容:相同的 API 可以在 Node.js 和瀏覽器中運行
- Promise-based:使用 async/await 更自然
- 標準化:遵循 W3C 規範
TransformStream 實戰
javascript
const { TransformStream } = require('node:stream/web');
async function createImageCompressor(options = {}) {
const { quality = 80 } = options;
return new TransformStream({
async transform(chunk, controller) {
const compressed = await compressImage(chunk, quality);
controller.enqueue(compressed);
},
flush(controller) {
console.log('壓縮完成');
}
});
}
背壓處理
javascript
const { Readable, Writable } = require('node:stream');
const readable = Readable.from(async function* () {
for (let i = 0; i < 1000000; i++) {
yield Buffer.from(`line ${i}\n`);
}
}());
const writable = new Writable({
write(chunk, encoding, callback) {
setTimeout(() => {
process.stdout.write(chunk);
callback();
}, 10);
}
});
// pipe 會自動處理背壓
readable.pipe(writable);
流組合器
javascript
const { pipeline } = require('node:stream/promises');
const { createGzip } = require('node:zlib');
async function compressFile(inputPath, outputPath) {
await pipeline(
fs.createReadStream(inputPath),
createGzip({ level: 6 }),
fs.createWriteStream(outputPath)
);
console.log('壓縮完成');
}
異步迭代器與流
javascript
const fs = require('node:fs');
const readline = require('node:readline');
async function processLargeFile(filePath) {
const fileStream = fs.createReadStream(filePath, { encoding: 'utf8' });
const rl = readline.createInterface({ input: fileStream });
let lineCount = 0;
for await (const line of rl) {
lineCount++;
if (line.includes('error')) {
console.log(`行 ${lineCount}: ${line}`);
}
}
console.log(`總共 ${lineCount} 行`);
}
總結
Node.js 22 的流處理 API 更現代、更安全。Web Streams API 提供瀏覽器兼容性,pipeline 提供安全的流組合,異步迭代器提供直觀的消費方式。2026 年的流處理原則:用 pipeline 組合流,用 AbortController 管理取消,用異步迭代器消費大數據。
