nodeJS入门例子一—事件（Event）

Events

events.EventEmitter

emitter.addListener(event, listener)

emitter.on(event, listener)

emitter.once(event, listener)

emitter.removeListener(event, listener)

emitter.removeAllListeners([event])

emitter.setMaxListeners(n)

emitter.listeners(event)

emitter.emit(event, [arg1], [arg2], [...])

Event: 'newListener'

Events

许多对象在Node中可以派发事件：一个net.Server每次一个链接链接到它时派发一个事件，当一个文件被打开时fs.readStream派发一个事件。所有派发事件的对象都是events.EventEmitter 的实体。可以通过 require('events') 访问此模块。

一般事件名称是用一个大小写混合（camel-cased ）的字符串表示，然而，没有严格的限制，因为任何字符串将被接受。

函数可以归宿某个对象，当事件派发时可以被执行。这些函数叫做监听器。

events.EventEmitter

可以通过require('events').EventEmitter访问EeventEmitter类。

当一个EventEmitter表达错误时，一般会派发一个'error'事件， Error事件在node中作为一个特例。如果没有对此做监听，默认行为就是打印错误日志并退出当前程序。

当一个新的监听添加时，所有EventEmitter派发一个'newListener'。

emitter.addListener(event, listener)

emitter.on(event, listener)

添加一个监听器到事件监听集合末端，为指定事件。

server.on('connection', function (stream) {
  console.log('someone connected!');
});

emitter.once(event, listener)

为事件添加一个一次性的监听器，这个监听器将只在事件下次激活时派发调用，在此之后这个监听将会被删除。

server.once('connection', function (stream) {
  console.log('Ah, we have our first user!');
});

emitter.removeListener(event, listener)

从事件监听器集合中删除指定的监听器。注意：在监听器之后改变监听器集合的索引。

var callback = function(stream) {
  console.log('someone connected!');
};
server.on('connection', callback);
// ...
server.removeListener('connection', callback);

emitter.removeAllListeners([event])

删除所有的事件监听。

emitter.setMaxListeners(n)

默认情况下当一个事件的监听超过10个时，EventEmitter 将打印警告信息。这对于内存泄漏的查找很有帮助。当然业非所有的Emitters都应该限制在10个。这些函数允许增长，设置0表示无限制。

emitter.listeners(event)

返回特定事件的事件监听器集合。这个集合可以人工干预，如删除一个事件监听器。

server.on('connection', function (stream) {
  console.log('someone connected!');
});
console.log(util.inspect(server.listeners('connection'))); // [ [Function] ]

emitter.emit(event, [arg1], [arg2], [...])

用提供的参数按顺序执行每个事件监听器。

Event: 'newListener'

function (event, listener) { }

当添加新的监听时，这个事件每次都会被派发