Node.js 核心模組(fs、http、stream 等)皆繼承自 events.EventEmitter。掌握其「監聽-觸發」模型,等於掌握了 Node 非同步程式設計的靈魂。本文以 jQuery 自定義事件為類比,快速建立心智模型。
var EventEmitter = require('events').EventEmitter;
var emitter = new EventEmitter();
// 監聽
emitter.on('some_event', function() {
console.log('事件觸發,執行回呼');
});
// 觸發(3 秒後)
setTimeout(function() {
emitter.emit('some_event');
}, 3000);
| 概念 | Node.js (EventEmitter) | jQuery |
|---|---|---|
| 綁定事件 | emitter.on(event, listener)emitter.addListener(...)(別名) | $el.on(event, handler) |
| 單次監聽 | emitter.once(event, listener) | $el.one(event, handler) |
| 移除監聽 | emitter.removeListener(event, listener)emitter.removeAllListeners([event]) | $el.off(event, handler) |
| 觸發事件 | emitter.emit(event, [arg1], [arg2], ...) | $el.trigger(event, [extraParams]) |
| 傳遞參數 | emit 後續參數直接傳給 listener | trigger 第 2 參數為陣列傳給 handler |
var EventEmitter = require('events').EventEmitter;
var util = require('util');
function MyResource(name) {
this.name = name;
EventEmitter.call(this); // 繼承
}
util.inherits(MyResource, EventEmitter);
MyResource.prototype.doWork = function() {
var self = this;
process.nextTick(function() {
self.emit('start', self.name);
// 模擬非同步工作
setTimeout(function() {
self.emit('data', { payload: 'chunk-1' });
self.emit('data', { payload: 'chunk-2' });
self.emit('end', 'completed');
}, 100);
});
};
// 使用
var res = new MyResource('Worker-1');
res.on('start', function(name) { console.log(name + ' 開始工作'); });
res.on('data', function(d) { console.log('收到資料:', d.payload); });
res.on('end', function(msg) { console.log('結束:', msg); });
res.doWork();
emit 是同步的,所有 listener 會依序執行完畢才回到呼叫端。'error' 事件,emit('error', err) 會拋出未捕獲異常導致進程崩潰,務必監聽 error。emitter.setMaxListeners(n) 調整。Node.js 的 EventEmitter 與 jQuery 自定義事件同屬「發布-訂閱」模式,差異在於前者為伺服器端核心基礎設施、後者為瀏覽器端 DOM 擴展。理解兩者異同,能讓你在全端開發中游刃有餘地設計事件驅動架構。