1、簡介
events是node.js 最重要的模塊,events模塊只提供了一個對象events.EventEmitter,EventEmitter 的核心是事件發(fā)射與事件監(jiān)聽器。
Node.js中大部分的模塊,都繼承自Event模塊。
與DOM樹上事件不同,不存在事件冒泡、逐層捕獲等行為。
EventEmitter 支持若干個事件監(jiān)聽器。當事件發(fā)射時,注冊到這個事件的事件監(jiān)聽器被依次調(diào)用,事件參數(shù)作為回調(diào)函數(shù)參數(shù)傳遞。
http://www.infoq.com/cn/articles/tyq-nodejs-event
訪問:
require('events');
2、事件常用函數(shù)及使用
emitter.on(event, listener)
/*
調(diào)用events模塊,獲取events.EventEmitter對象
*/
var EventEmitter = require('events').EventEmitter;
var ee = new EventEmitter();
/*
EventEmitter.on(event, listener) 為事件注冊一個監(jiān)聽
參數(shù)1:event 字符串,事件名
參數(shù)2:回調(diào)函數(shù)
*/
ee.on('some_events', function(cat, dog) {
console.log("第1個監(jiān)聽事件,參數(shù)cat=" + cat + ",dog="+dog );
});
console.log('第一輪');
ee.emit('some_events', 'Tom', 'Tian');
console.log('第二輪');
ee.emit('some_events', 'Tom', 'T');
//EventEmitter.on(event, listener) 示例源碼
emitter.emit(event, [arg1], [arg2], [...])
/*
調(diào)用events模塊,獲取events.EventEmitter對象
*/
var EventEmitter = require('events').EventEmitter;
var ee = new EventEmitter();
/*
EventEmitter.on(event, listener) 為事件注冊一個監(jiān)聽
參數(shù)1:event 字符串,事件名
參數(shù)2:回調(diào)函數(shù)
*/
ee.on('some_events', function(cat, dog) {
console.log("第1個監(jiān)聽事件,參數(shù)cat=" + cat + ",dog="+dog );
});
/*
EventEmitter.emit(event, [arg1], [arg2], [...]) 觸發(fā)指定事件
參數(shù)1:event 字符串,事件名
參數(shù)2:可選參數(shù),按順序傳入回調(diào)函數(shù)的參數(shù)
返回值:該事件是否有監(jiān)聽
*/
var isSuccess = ee.emit('some_events', 'Tom', 'Tian');
ee.on('some_events', function(cat, dog) {
console.log("第2個監(jiān)聽事件,參數(shù)cat=" + cat + ",dog="+dog );
});
ee.emit('some_events', 'zhong', 'wei');
var isSuccess2 = ee.emit('other_events', 'Tom', 'Tian');
console.log(isSuccess);
console.log(isSuccess2);
emitter.once(event, listener)
emitter.once注冊監(jiān)聽是一次性監(jiān)聽,當觸發(fā)一次后,會移除該監(jiān)聽!
/*
調(diào)用events模塊,獲取events.EventEmitter對象
*/
var EventEmitter = require('events').EventEmitter;
var ee = new EventEmitter();
/*
EventEmitter.once(event, listener) 為事件注冊一次性監(jiān)聽,觸發(fā)一次后移除監(jiān)聽
參數(shù)1:event 字符串,事件名
參數(shù)2:回調(diào)函數(shù)
*/
ee.once('some_events', function(cat, dog) {
console.log("第1個監(jiān)聽事件,參數(shù)cat=" + cat + ",dog="+dog );
});
console.log('第一輪');
ee.emit('some_events', 'Wilson', 'Zhong');
console.log('第二輪');
var isSuccess = ee.emit('some_events', 'Wilson', 'Zhong');
console.log(isSuccess);
emitter.removeListener(event, listener)
給some_events添加了三個監(jiān)聽,又移除了第一個和第三個監(jiān)聽,最后再用emitter.emit觸發(fā)some_events,輸出結(jié)果不難發(fā)現(xiàn),用emitter.removeListener移除的第一個和第三個監(jiān)聽都沒有再起作用
var EventEmitter = require('events').EventEmitter;
var ee = new EventEmitter();
var listener = function(dog,cat)
{
console.log("第1個監(jiān)聽事件,參數(shù)dog=" + dog + ",cat="+cat );
}
var listener2= function(dog,cat)
{
console.log("第2個監(jiān)聽事件,參數(shù)dog=" + dog + ",cat="+cat );
}
var listener3= function(dog,cat)
{
console.log("第3個監(jiān)聽事件,參數(shù)dog=" + dog + ",cat="+cat );
}
ee.on('some_events', listener);
ee.on('some_events', listener2);
ee.on('some_events', listener3);
/*
EventEmitter.removeListener(event, listener) 移除指定事件的監(jiān)聽器
注意:該監(jiān)聽器必須是注冊過的
*/
ee.removeListener('some_events', listener);
ee.removeListener('some_events', listener3);
ee.emit('some_events', 'Wilson', 'Zhong');
emitter.removeAllListeners([event])
emitter.removeAllListeners傳用事件名作為參數(shù)時,為移除傳入事件名的所有監(jiān)聽,而不會影響其它事件監(jiān)聽!
emitter.removeAllListeners可以不傳用事件名參數(shù);直接執(zhí)行
removeAllListeners(); //移除所有監(jiān)聽?。ū容^暴力的方法一般要慎用~~)
emitter.listeners(event)
var EventEmitter = require('events').EventEmitter;
var ee = new EventEmitter();
var listener = function(dog,cat)
{
console.log("第1個監(jiān)聽事件,參數(shù)dog=" + dog + ",cat="+cat );
}
var listener2= function(dog,cat)
{
console.log("第2個監(jiān)聽事件,參數(shù)dog=" + dog + ",cat="+cat );
}
ee.on('some_events', listener);
ee.on('some_events', listener2);
ee.on('other_events',function(dog,cat)
{
console.log("其它監(jiān)聽事件,參數(shù)dog=" + dog + ",cat="+cat );
});
/*
EventEmitter.listeners(event) //返回指定事件的監(jiān)聽數(shù)組
參數(shù)1:event 字符串,事件名
*/
var listenerEventsArr = ee.listeners('some_events');
console.log(listenerEventsArr.length)
for (var i = listenerEventsArr.length - 1; i >= 0; i--) {
console.log(listenerEventsArr[i]);
};
emitter.setMaxListeners(n)
var EventEmitter = require('events').EventEmitter;
var ee = new EventEmitter();
/*
EventEmitter.setMaxListeners (n) 給EventEmitter設(shè)置最大監(jiān)聽
參數(shù)1: n 數(shù)字類型,最大監(jiān)聽數(shù)
超過10個監(jiān)聽時,不設(shè)置EventEmitter的最大監(jiān)聽數(shù)會提示:
(node) warning: possible EventEmitter memory leak detected. 11 listeners added.
Use emitter.setMaxListeners() to increase limit.
設(shè)計者認為偵聽器太多,可能導(dǎo)致內(nèi)存泄漏,所以存在這樣一個警告
*/
ee.setMaxListeners(15);
/*
給EventEmitter 添加11個監(jiān)聽
*/
for (var i = 10; i >= 0; i--) {
ee.on('some_events',function()
{
console.log('第'+ (i +1) +'個監(jiān)聽');
});
};
EventEmitter.defaultMaxListeners
EventEmitter.defaultMaxListeners功能與setMaxListeners類似,
給所有EventEmitter設(shè)置最大監(jiān)聽
setMaxListeners優(yōu)先級大于defaultMaxListeners
EventEmitter.listenerCount(emitter, event)
返回指定事件的監(jiān)聽數(shù)
特殊的事件Error
引用自Node.js開發(fā)指南:EventEmitter 定義了一個特殊的事件 error,它包含了“錯誤”的語義,我們在遇到 異常的時候通常會發(fā)射 error 事件。當 error 被發(fā)射時,EventEmitter 規(guī)定如果沒有響 應(yīng)的監(jiān)聽器,Node.js 會把它當作異常,退出程序并打印調(diào)用棧。我們一般要為會發(fā)射 error 事件的對象設(shè)置監(jiān)聽器,避免遇到錯誤后整個程序崩潰。
其他的一些內(nèi)容:https://nodejs.org/api/events.html