事件機制的靈魂在於「觸發」。emitter.emit 就是那個負責發射事件、並把參數傳給所有監聽器的核心方法。
它會主動觸發指定的 event,並將後續的可選參數依序傳入各個事件監聽器中。
emitter.emit(event, [arg1], [arg2], [...])
var events = require('events');
var emitter = new events.EventEmitter();
emitter.on('someEvent', function(arg1, arg2){
console.log('listener1', arg1, arg2);
})
emitter.on('someEvent', function(arg1, arg2){
console.log('listener2', arg1, arg2);
})
emitter.emit('someEvent', 'byvoid', 1991);
這裡我們為 someEvent 掛上兩個監聽器,接著用 emit 觸發它並帶入兩個參數。執行後,兩個監聽器都會依序被呼叫,各自印出收到的參數。
emit 的實作相當講究效能,它針對不同參數個數做了快速分支處理,並對 error 事件做了特別的例外防護——若沒有任何 error 監聽器,將直接拋出錯誤:
EventEmitter.prototype.emit = function(type) {
var er, handler, len, args, i, listeners;
if (!this._events)
this._events = {};
// If there is no 'error' event listener then throw.
if (type === 'error') {
if (!this._events.error ||
(util.isObject(this._events.error) && !this._events.error.length)) {
er = arguments[1];
if (this.domain) {
if (!er) er = new TypeError('Uncaught, unspecified "error" event.');
er.domainEmitter = this;
er.domain = this.domain;
er.domainThrown = false;
this.domain.emit('error', er);
} else if (er instanceof Error) {
throw er; // Unhandled 'error' event
} else {
throw TypeError('Uncaught, unspecified "error" event.');
}
return false;
}
}
handler = this._events[type];
if (util.isUndefined(handler))
return false;
// ... 後續依 handler 型別分派呼叫
return true;
};
理解 emit 的行為,是精通 Node.js 事件驅動模型的關鍵一步。