node.js基础（三）：Event

基本用法

Events模块是Node对“发布/订阅”模式（publish/subscribe）的实现。

该模块通过EventEmitter属性，提供了一个构造函数。 该构造函数的实例具有on方法，可以用来监听指定事件，并触发回调函数。

var EventEmitter = require('events').EventEmitter;
var ee = new EventEmitter();

ee.on('someEvent', function () {
  console.log('event has occured');
});

function f() {
  console.log('start');
  ee.emit('someEvent');
  console.log('end');
}

f()
// start
// event has occured
// end

on方法

默认情况下，Node.js允许同一个事件最多可以指定10个回调函数。

ee.on("someEvent", function () { console.log("event 1"); });
ee.on("someEvent", function () { console.log("event 2"); });
ee.on("someEvent", function () { console.log("event 3"); });

超过10个回调函数，会发出一个警告。这个门槛值可以通过setMaxListeners方法改变。

emit方法

EventEmitter实例的emit方法，用来触发事件。它的第一个参数是事件名称，其余参数都会依次传入回调函数。

var EventEmitter = require('events').EventEmitter;
var myEmitter = new EventEmitter;

var connection = function(id){
  console.log('client id: ' + id);
};

myEmitter.on('connection', connection);
myEmitter.emit('connection', 6);

removeListener方法

该方法用于移除回调函数。它接受两个参数，第一个是事件名称，第二个是回调函数名称。这就是说，不能用于移除匿名函数。

var EventEmitter = require('events').EventEmitter;

var emitter = new EventEmitter;

emitter.on('message', console.log);

setInterval(function(){
  emitter.emit('message', 'foo bar');
}, 300);

setTimeout(function(){
  emitter.removeListener('message', console.log);
}, 1000);

上面代码每300毫秒触发一次message事件，直到1000毫秒后取消监听。

removeAllListeners方法

该方法用于移除某个事件的所有回调函数。

var EventEmitter = require('events').EventEmitter;

var emitter = new EventEmitter;

// some code here

emitter.removeAllListeners("firstConnection");

如果不带参数，则表示移除所有事件的所有回调函数。

listeners方法

listeners方法接受一个事件名称作为参数，返回该事件所有回调函数组成的数组。

var EventEmitter = require('events').EventEmitter;

var ee = new EventEmitter;

function onlyOnce () {
  console.log(ee.listeners("firstConnection"));
  ee.removeListener("firstConnection", onlyOnce);
  console.log(ee.listeners("firstConnection"));
}

ee.on("firstConnection", onlyOnce)
ee.emit("firstConnection");
ee.emit("firstConnection");

// [ [Function: onlyOnce] ]
// []

上面代码显示两次回调函数组成的数组，第一次只有一个回调函数onlyOnce，第二次是一个空数组，因为removeListener方法取消了回调函数。