目录

 事件

Class: events.EventEmitter

    为了访问 EventEmitter 类，require(‘events‘).EventEmitter。
    当一个 EventEmitter 实例遇到一个错误，典型的操作是发射一个 ‘error‘ 事件。 在node 中 Error 事件作为特殊情况对待。如果它没有任何监听器，那么默认的操作是打印堆栈跟踪信息然后退出程序。
    所有的 EventEmitter 都会在新的监听器添加时发射事件 ‘newListener‘，在监听器移除时发射事件 ‘removeListener‘。

emitter.addListener(event, listener)
emitter.on(event, listener)

    为特定的事件添加一个监听器到监听器数组的末尾。

1 server.on(‘connection‘, function(stream) {
2   console.log(‘someone connected!‘);
3 });

    返回发射器，因而可以链式调用。

emitter.once(event, listener)

   为事件添加一个执行一次的监听器。监听器只在下次事件触发的时候调用，之后它会被移除。

1 server.once(‘connection‘, function(streams) {
2   console.log(‘Ah, we have our first user!‘);
3 });

   返回发射器，因而可以链式调用。

emitter.removeListener(event, listener)

    为指定的事件从监听器数组里移除指定的监听器。警告：这将改变该监听器后面的监听器元素的数组下标。

1 var callback = function(stream) {
2   console.log(‘someone connected!‘);
3 };
4 server.on(‘connection‘, callback);
5 // ...
6 server.removeListener(‘connection‘, callback);

     返回发射器，因而可以链式调用。

emitter.removeAllListener([event])

    移除所有的监听器，或特定时间的所有监听器。移除在代码其它地方添加的监听器不是一个好主意，特别是当它关联在一个不是你创建的发射器上（例如 socket 或文件流）。
    返回发射器，因而可以链式调用。

emitter.setMaxListeners(n)

     默认情况下如果超过10个监听器被添加到特定的事件上， EventEmitter 将打印一个警告。这是一个有用的默认值，可以帮助找到内存泄露。明显地不是所有发射器应该限制为10。本函数允许它增长。若无限制设置为0。

emitter.listeners(event)

    返回特定事件的监听器数组。

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

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

    使用提供的参数按顺序执行每个监听器。
    如果有监听器返回 true，否则返回 false。

Class Method: EventEmitter.listenerCount(emitter, event)

    返回给出事件的监听器数量。

Event: ‘newListener‘

    ● event 字符串类型 事件名
    ● listener 函数类型 事件处理函数

    在每次添加新的监听器时本事件被发射。如果 listener 在 emitter.listeners(event) 返回的列表中，本函数的行为未明确指明。

Event: ‘removeListener‘

    ● event 字符串类型 事件名
    ● listener 函数类型 事件处理函数

    在每次移除监听器时本事件被发射。如果 listener 在 emitter.listeners(event) 返回的列表中，本函数的行为未明确指明。

Node.js API —— Events（事件）