Stream(串流)是 Node.js 處理資料流的核心抽象,源自 Unix 哲學:**「一切皆檔案,程式透過管道 `|` 串接」**。一個程式的標準輸出可直接作為下一個程式的標準輸入,實現記憶體高效的資料處理。
在 Node 中,Stream 代表**可被管道串接的資料流能力**,核心方法為 .pipe():
// 伪代碼
Readable.pipe(Writable); // 上游.pipe(下游)
| 類型 | 繼承自 | 核心實作方法 | 典型例子 |
|---|---|---|---|
| Readable (可讀) | EventEmitter | _read() | fs.createReadStream, HTTP request, process.stdin |
| Writable (可寫) | EventEmitter | _write() | fs.createWriteStream, HTTP response, process.stdout |
| Duplex (雙工) | Readable + Writable | 兩者皆需實作 | net.Socket, zlib |
| Transform (轉換) | Duplex | _transform() | zlib.createGzip, crypto.createCipher |
readable、data、end、close、error.read()、.pause()、.resume()、.pipe()、.unpipe()drain、pipe、unpipe、error、finish.write()、.end()、.cork()、.uncork()初始為 **Paused Mode(暫停模式)**,需主動讀取;切換為 **Flowing Mode(流動模式)**:
| 觸發行為 | 切換方向 |
|---|---|
監聽 data 事件 | Paused → Flowing |
呼叫 .resume() | Paused → Flowing |
呼叫 .pipe(writable) | Paused → Flowing |
未 pipe 時呼叫 .pause() | Flowing → Paused |
已 pipe 時移除所有 data 監聽並 .unpipe() | Flowing → Paused |
// parser.js
process.stdin.on('readable', function() {
var buf = process.stdin.read();
if (buf) {
var data = buf.toString();
// parsing data ...
console.log('收到:', data.trim());
}
});
// 使用:head -10 some.txt | node parser.js
req.on('connect', function(res, socket, head) {
socket.on('data', function(chunk) {
console.log(chunk.toString());
});
socket.on('end', function() {
proxy.close();
});
});
// 用戶 A 上傳 → 暫存 req
router.post('/post', function(req, res) {
var destination = req.headers['destination'];
cache[destination] = req; // 不回應,保持連線
});
// 用戶 B 請求 → 串流轉發
router.get('/inbox', function(req, res) {
var user = req.headers['user'];
cache.find(user, function(err, previousReq) {
var form = new multiparty.Form();
form.parse(previousReq);
form.on('part', function(part) {
part.pipe(res); // 直接管道轉發,零記憶體複製
part.on('error', function(err) { res.end(err); });
});
});
});
var EE = require('events').EventEmitter;
var util = require('util');
util.inherits(Stream, EE);
function Stream() { EE.call(this); }
Stream 本質是 EventEmitter,擁有完整事件驅動能力,符合 Node.js 非同步非阻塞本質。
掌握 Stream,即掌握 Node.js 高效 I/O 的靈魂。從簡單的檔案複製到複雜的即時轉碼、代理轉發,Stream 都是不可或缺的利器。