Node.js日記:Events

簡介

events 是 Node.js 最重要的模塊,沒有“之一” ,原因是 Node.js 本身架構就是事件式的,而它提供了唯一的接口,所以堪稱 Node.js 事件編程的基石。

events 模塊不僅用於用戶代碼與 Node.js 下層事件循環的交互,還幾乎被所有的模塊依賴。

例如,net.Server 會在每次有新連接時觸發事件,fs.ReadStream 會在打開文件時觸發事件。

EventEmitter

events 模塊只提供了一個對象:events.EventEmitter

EventEmitter 的核心就是事件觸發與事件監聽器功能的封裝;

EventEmitter 的每個事件由一個事件名和若干個參數組成,事件名是一個字符串,通常表達一定的語義;

對於每個事件, EventEmitter 支持若干個事件監聽器。當事件觸發時,註冊到這個事件的事件監聽器被依次調用,事件參數作爲回調函數參數傳遞。

常用 API 如下:

- on(event, listener):爲指定事件註冊一個監聽器,接受一個字符串 event 和一個回調函數 listener。

- emit(event, [arg1], [arg2], [...]):觸發 event 事件,傳遞若干可選參數到事件監聽器的參數表。

- once(event, listener):爲指定事件註冊一個單次監聽器,即監聽器最多隻會觸發一次,觸發後立刻解除該監聽器。

- removeListener(event, listener):移除指定事件的某個監聽器,listener 必須是該事件已經註冊過的監聽器。

- removeAllListeners([event]):移除所有事件的所有監聽器,若指定 event ,則移除指定事件的所有監聽器。

代碼舉例:

const events = require('events');
let 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', 'lony', 1988);        // 觸發事件

error 事件

EventEmitter 定義了一個特殊的事件 error ,它包含了“錯誤”的語義,我們在遇到異常的時候通常會發射 error 事件。

當 error 被髮射時,EventEmitter 規定如果沒有響應的監聽器,Node.js 會把它當作異常,退出程序並打印調用棧。

我們一般要爲會發射 error 事件的對象設置監聽器,避免遇到錯誤後整個程序崩潰。

例如:

const events = require('events');
let emitter = new events.EventEmitter();
emitter.emit('error');

繼承 EventEmitter

大多數時候我們不會直接使用 EventEmitter ,而是在對象中繼承它。

包括 fs 、 net 、http 在內的,只要是支持事件響應的核心模塊都是 EventEmitter 的子類。

爲什麼要這樣做呢?

原因有兩點:

首先,具有某個實體功能的對象實現事件符合語義,事件的監聽和觸發應該是一個對象的方法;

其次 JavaScript 的對象機制是基於原型的,支持部分多重繼承,繼承  EventEmitter 不會打亂對象原有的繼承關係。

 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章