[1]EventEmitter [2]方法 [3]設置 [4]事件 ...
前面的話
events模塊是node的核心模塊,幾乎所有常用的node模塊都繼承了events模塊,比如http、fs等。本文將詳細介紹nodeJS中的事件機制
EventEmitter
多數 Node.js 核心 API 都是採用慣用的非同步事件驅動架構,其中某些類型的對象(稱為觸發器)會周期性地觸發命名事件來調用函數對象(監聽器)。例如,一個net.Server對象會在每次有新連接時觸發一個事件;一個 fs.ReadStream 會在文件被打開時觸發一個事件;一個 stream會在數據可讀時觸發事件。
【EventEmitter】
EventEmitter 類由 events 模塊定義和開放的,所有能觸發事件的對象都是 EventEmitter 類的實例
var EventEmitter = require('events'); /* { [Function: EventEmitter] EventEmitter: [Circular], usingDomains: false, defaultMaxListeners: [Getter/Setter], init: [Function], listenerCount: [Function] } */ console.log(EventEmitter);
events模塊的EventEmitter屬性指向該模塊本身
var events = require('events'); console.log(events.EventEmitter === events);//true
EventEmitter是一個構造函數,可以用來生成事件發生器的實例emitter
var EventEmitter = require('events'); var emitter = new EventEmitter(); /* EventEmitter { domain: null, _events: {}, _eventsCount: 0, _maxListeners: undefined } */ console.log(emitter);
方法
【emitter.emit(eventName[, ...args])】
eventName <any>
...args <any>
該方法按監聽器的註冊順序,同步地調用每個註冊到名為eventName事件的監聽器,並傳入提供的參數。如果事件有監聽器,則返回true,否則返回false
var EventEmitter = require('events'); var emitter = new EventEmitter(); emitter.on('test1',function(){}); console.log(emitter.emit('test1'));//true console.log(emitter.emit('test2'));//false
【emitter.on(eventName, listener)】
該方法用於添加listener函數到名為eventName的事件的監聽器數組的末尾
eventName <any> 事件名
listener <Function> 回調函數
[註意]不會檢查listener是否已被添加。多次調用並傳入相同的eventName和listener會導致listener被添加與調用多次
var EventEmitter = require('events'); var emitter = new EventEmitter(); emitter.on('test',function(){ console.log(1); }); emitter.on('test',function(){ console.log(2); }); emitter.emit('test');//1 2
該方法返回一個 EventEmitter 引用,可以鏈式調用
var EventEmitter = require('events'); var emitter = new EventEmitter(); emitter.on('test',function(){ console.log(1); }).on('test',function(){ console.log(2); }); emitter.emit('test');//1 2
【emitter.addListener(eventName, listener)】
emitter.on(eventName, listener) 的別名
var EventEmitter = require('events'); var emitter = new EventEmitter(); emitter.addListener('test',function(){ console.log(1); }); emitter.emit('test');//1
【emitter.prependListener()】
與on()方法不同,prependListener()方法可用於將事件監聽器添加到監聽器數組的開頭
var EventEmitter = require('events'); var emitter = new EventEmitter(); emitter.on('test',function(){ console.log(1); }).prependListener('test',function(){ console.log(2); }); emitter.emit('test');//2 1
【emitter.once(eventName, listener)】
該方法添加一個單次 listener 函數到名為 eventName 的事件。 下次觸發 eventName 事件時,監聽器會被移除,然後調用
eventName <any> 事件名
listener <Function> 回調函數
var EventEmitter = require('events'); var emitter = new EventEmitter(); emitter.on('test',function(){ console.log(1); }).once('test',function(){ console.log(2); }); emitter.emit('test');//1 2 emitter.emit('test');//1
【emitter.prependOnceListener() 】
該方法用於將事件監聽器添加到監聽器數組開頭。下次觸發eventName事件時,監聽器會被移除,然後調用
var EventEmitter = require('events'); var emitter = new EventEmitter(); emitter.on('test',function(){ console.log(1); }).prependOnceListener('test',function(){ console.log(2); }); emitter.emit('test');//2 1 emitter.emit('test');//1
【emitter.removeAllListeners([eventName])】
eventName <any>
移除全部或指定 eventName 的監聽器,返回一個 EventEmitter 引用,可以鏈式調用
[註意]在代碼中移除其他地方添加的監聽器是一個不好的做法,尤其是當 EventEmitter 實例是其他組件或模塊(如 socket 或文件流)創建的
var EventEmitter = require('events'); var emitter = new EventEmitter(); emitter.on('test',function(){ console.log(1); }).removeAllListeners('test'); emitter.emit('test');//''
【emitter.removeListener(eventName, listener)】
eventName <any>
listener <Function>
從名為 eventName 的事件的監聽器數組中移除指定的 listener
var EventEmitter = require('events'); var emitter = new EventEmitter(); function show(){ console.log(1); } emitter.on('test',show).removeListener('test',show); emitter.emit('test');//''
[註意]removeListener最多只會從監聽器數組裡移除一個監聽器實例。如果任何單一的監聽器被多次添加到指定eventName的監聽器數組中,則必須多次調用removeListener才能移除每個實例
var EventEmitter = require('events'); var emitter = new EventEmitter(); function show(){ console.log(1); } emitter.on('test',show).on('test',show).removeListener('test',show); emitter.emit('test');//'1'
[註意]一旦一個事件被觸發,所有綁定到它的監聽器都會按順序依次觸發。這意味著,在事件觸發後、最後一個監聽器完成執行前,任何 removeListener() 或 removeAllListeners() 調用都不會從 emit() 中移除它們。 隨後的事件會像預期的那樣發生
因為監聽器是使用內部數組進行管理的,所以調用它會改變在監聽器被移除後註冊的任何監聽器的位置索引。 雖然這不會影響監聽器的調用順序,但意味著由 emitter.listeners() 方法返回的監聽器數組副本需要被重新創建
var EventEmitter = require('events'); var emitter = new EventEmitter(); function show1(){ console.log(1); emitter.removeListener('test',show2); } function show2(){ console.log(2); } emitter.on('test',show1).on('test',show2); emitter.emit('test');//1 2 emitter.emit('test');//1
設置
【emitter.eventNames()】
返回一個列出觸發器已註冊監聽器的事件的數組。 數組中的值為字元串或符號
var EventEmitter = require('events'); var emitter = new EventEmitter(); emitter.addListener('test1',function(){console.log(1);}); emitter.addListener('test2',function(){console.log(2);}); console.log(emitter.eventNames());//[ 'test1', 'test2' ]
【emitter.listenerCount(eventName)】
eventName <any> 正在被監聽的事件名
返回正在監聽名為 eventName 的事件的監聽器的數量
var EventEmitter = require('events'); var emitter = new EventEmitter(); emitter.addListener('test',function(){console.log(1);}); emitter.addListener('test',function(){console.log(1);}); console.log(emitter.listenerCount('test'));//2
【emitter.listeners(eventName)】
eventName <any>
返回名為 eventName 的事件的監聽器數組的副本
var EventEmitter = require('events'); var emitter = new EventEmitter(); emitter.addListener('test',function(){console.log(1);}); emitter.addListener('test',function(){console.log(2);}); console.log(emitter.listeners('test'));//[ [Function], [Function] ] emitter.listeners('test')[0]();//1
【emitter.getMaxListeners()】
返回 EventEmitter 當前的最大監聽器限制值
var EventEmitter = require('events'); var emitter = new EventEmitter(); console.log(emitter.getMaxListeners());//10
【emitter.setMaxListeners(n)】
預設情況下,如果為特定事件添加了超過 10 個監聽器,則 EventEmitter 會列印一個警告。 此限制有助於尋找記憶體泄露。 但是,並不是所有的事件都要被限為 10 個。 emitter.setMaxListeners() 方法允許修改指定的 EventEmitter 實例的限制。 值設為 Infinity(或 0)表明不限制監聽器的數量。返回一個 EventEmitter 引用,可以鏈式調用
var EventEmitter = require('events'); var emitter = new EventEmitter(); emitter.on('a',function(){}).on('a',function(){}).on('a',function(){}).on('a',function(){}).on('a',function(){}).on('a',function(){}).on('a',function(){}).on('a',function(){}).on('a',function(){}).on('a',function(){}).on('a',function(){}); /* Warning: Possible EventEmitter memory leak detected. 11 a listeners added. Use emitter.setMaxListeners() to increase limit */
var EventEmitter = require('events'); var emitter = new EventEmitter(); emitter.setMaxListeners(11); emitter.on('a',function(){}).on('a',function(){}).on('a',function(){}).on('a',function(){}).on('a',function(){}).on('a',function(){}).on('a',function(){}).on('a',function(){}).on('a',function(){}).on('a',function(){}).on('a',function(){});
【EventEmitter.defaultMaxListeners】
每個事件預設可以註冊最多10個監聽器。單個EventEmitter實例的限制可以使用emitter.setMaxListeners(n)方法改變。所有EventEmitter實例的預設值可以使用EventEmitter.defaultMaxListeners屬性改變
[註意]設置 EventEmitter.defaultMaxListeners 要謹慎,因為會影響所有EventEmitter 實例,包括之前創建的。因而,調用 emitter.setMaxListeners(n) 優先於 EventEmitter.defaultMaxListeners
var EventEmitter = require('events'); var emitter = new EventEmitter(); EventEmitter.defaultMaxListeners = 11; emitter.on('a',function(){}).on('a',function(){}).on('a',function(){}).on('a',function(){}).on('a',function(){}).on('a',function(){}).on('a',function(){}).on('a',function(){}).on('a',function(){}).on('a',function(){}).on('a',function(){});
事件
【'newListener' 事件】
eventName <any> 要監聽的事件的名稱
listener <Function> 事件的句柄函數
EventEmitter 實例會在一個監聽器被添加到其內部監聽器數組之前觸發自身的 'newListener' 事件
註冊了 'newListener' 事件的監聽器會傳入事件名與被添加的監聽器的引用。事實上,在添加監聽器之前觸發事件有一個微妙但重要的副作用: 'newListener' 回調中任何額外的被註冊到相同名稱的監聽器會在監聽器被添加之前被插入
var EventEmitter = require('events'); var emitter = new EventEmitter(); emitter.on('newListener',function(){ console.log(2); }) emitter.on('test',function(){ console.log(1); }) emitter.emit('test');//2 1
var EventEmitter = require('events'); var emitter = new EventEmitter(); emitter.on('test',function(){ console.log(1); }) emitter.on('newListener',function(){ console.log(2); }) emitter.emit('test');//1
【'removeListener' 事件】
eventName <any> 事件名
listener <Function> 事件句柄函數
'removeListener' 事件在 listener 被移除後觸發
var EventEmitter = require('events'); var emitter = new EventEmitter(); function show(){ console.log(1); } emitter.on('removeListener',function(){ console.log(2);//2 }) emitter.on('test',show).removeListener('test',show);
var EventEmitter = require('events'); var emitter = new EventEmitter(); function show(){ console.log(1); } emitter.on('test',show).removeListener('test',show); emitter.on('removeListener',function(){ console.log(2);//'' })
var EventEmitter = require('events'); var emitter = new EventEmitter(); function show(){ console.log(1); } emitter.removeListener('test',show); emitter.on('removeListener',function(){ console.log(2);//'' })