对象 EventEmitter

EventEmitter 是事件触发对象，它可以被用于建立观察者模式，支持事件触发的对象均继承于此

当一个事件被触发时，所有与该事件相关联的监听器会以异步方式被调用。它还允许我们创建具有高度可定制性和灵活性的代码。

常用函数包括：addListener/on、once、removeListener/off、removeAllListeners 和 emit。

下面是一个示例代码：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
var fs = require('fs');
var EventEmitter = require('events');
var event = new EventEmitter();

event.on('read_file', function(filename) {
    fs.readFile(filename, 'utf8', function(err, data) {
        if (err) {
            event.emit('error', err);
            return;
        }
        event.emit('show_content', data);
    });
});

event.on('error', function(err) {
    console.log(`Error ${err}`);
});

event.on('show_content', function(content) {
    console.log(content);
});

event.emit('read_file', 'test.txt');

上述示例代码，当运行时，事件emitter实例event首先监听'read_file'事件，然后在事件触发时(event.emit('read_file', 'test.txt'))触发读取文件的操作。当读取成功后，会触发'show_content'事件，此时监听了'show_content'事件的函数就会被执行并显示文件内容。如果在读取文件过程中发生错误，则会触发'error'事件，此时操作失败的情况就得到了应对。

这种模式在应对异步操作的业务场景中具有很好的优越性。

继承关系

构造函数

EventEmitter

构造函数

1
new EventEmitter();

对象

事件触发对象

1
EventEmitter new EventEmitter;

静态属性

defaultMaxListeners

Integer, 默认全局最大监听器数

1
static Integer EventEmitter.defaultMaxListeners;

成员函数

on

绑定一个事件处理函数到对象

1
2
Object EventEmitter.on(String ev,
    Function func);

调用参数:

ev: String, 指定事件的名称
func: Function, 指定事件处理函数

返回结果:

Object, 返回事件对象本身，便于链式调用

绑定一个事件处理函数到对象

1
Object EventEmitter.on(Object map);

调用参数:

map: Object, 指定事件映射关系，对象属性名称将作为事件名称，属性的值将作为事件处理函数

返回结果:

Object, 返回事件对象本身，便于链式调用

addListener

绑定一个事件处理函数到对象

1
2
Object EventEmitter.addListener(String ev,
    Function func);

调用参数:

ev: String, 指定事件的名称
func: Function, 指定事件处理函数

返回结果:

Object, 返回事件对象本身，便于链式调用

绑定一个事件处理函数到对象

1
Object EventEmitter.addListener(Object map);

调用参数:

map: Object, 指定事件映射关系，对象属性名称将作为事件名称，属性的值将作为事件处理函数

返回结果:

Object, 返回事件对象本身，便于链式调用

prependListener

绑定一个事件处理函数到对象起始

1
2
Object EventEmitter.prependListener(String ev,
    Function func);

调用参数:

ev: String, 指定事件的名称
func: Function, 指定事件处理函数

返回结果:

Object, 返回事件对象本身，便于链式调用

绑定一个事件处理函数到对象起始

1
Object EventEmitter.prependListener(Object map);

调用参数:

map: Object, 指定事件映射关系，对象属性名称将作为事件名称，属性的值将作为事件处理函数

返回结果:

Object, 返回事件对象本身，便于链式调用

once

绑定一个一次性事件处理函数到对象，一次性处理函数只会触发一次

1
2
Object EventEmitter.once(String ev,
    Function func);

调用参数:

ev: String, 指定事件的名称
func: Function, 指定事件处理函数

返回结果:

Object, 返回事件对象本身，便于链式调用

绑定一个一次性事件处理函数到对象，一次性处理函数只会触发一次

1
Object EventEmitter.once(Object map);

调用参数:

map: Object, 指定事件映射关系，对象属性名称将作为事件名称，属性的值将作为事件处理函数

返回结果:

Object, 返回事件对象本身，便于链式调用

prependOnceListener

绑定一个事件处理函数到对象起始

1
2
Object EventEmitter.prependOnceListener(String ev,
    Function func);

调用参数:

ev: String, 指定事件的名称
func: Function, 指定事件处理函数

返回结果:

Object, 返回事件对象本身，便于链式调用

绑定一个事件处理函数到对象起始

1
Object EventEmitter.prependOnceListener(Object map);

调用参数:

map: Object, 指定事件映射关系，对象属性名称将作为事件名称，属性的值将作为事件处理函数

返回结果:

Object, 返回事件对象本身，便于链式调用

off

从对象处理队列中取消指定函数

1
2
Object EventEmitter.off(String ev,
    Function func);

调用参数:

ev: String, 指定事件的名称
func: Function, 指定事件处理函数

返回结果:

Object, 返回事件对象本身，便于链式调用

取消对象处理队列中的全部函数

1
Object EventEmitter.off(String ev);

调用参数:

ev: String, 指定事件的名称

返回结果:

Object, 返回事件对象本身，便于链式调用

从对象处理队列中取消指定函数

1
Object EventEmitter.off(Object map);

调用参数:

map: Object, 指定事件映射关系，对象属性名称作为事件名称，属性的值作为事件处理函数

返回结果:

Object, 返回事件对象本身，便于链式调用

removeListener

从对象处理队列中取消指定函数

1
2
Object EventEmitter.removeListener(String ev,
    Function func);

调用参数:

ev: String, 指定事件的名称
func: Function, 指定事件处理函数

返回结果:

Object, 返回事件对象本身，便于链式调用

取消对象处理队列中的全部函数

1
Object EventEmitter.removeListener(String ev);

调用参数:

ev: String, 指定事件的名称

返回结果:

Object, 返回事件对象本身，便于链式调用

从对象处理队列中取消指定函数

1
Object EventEmitter.removeListener(Object map);

调用参数:

map: Object, 指定事件映射关系，对象属性名称作为事件名称，属性的值作为事件处理函数

返回结果:

Object, 返回事件对象本身，便于链式调用

removeAllListeners

从对象处理队列中取消所有事件的所有监听器，如果指定事件，则移除指定事件的所有监听器。

1
Object EventEmitter.removeAllListeners(String ev);

调用参数:

ev: String, 指定事件的名称

返回结果:

Object, 返回事件对象本身，便于链式调用

从对象处理队列中取消所有事件的所有监听器，如果指定事件，则移除指定事件的所有监听器。

1
Object EventEmitter.removeAllListeners(Array evs = []);

调用参数:

evs: Array, 指定事件的名称

返回结果:

Object, 返回事件对象本身，便于链式调用

setMaxListeners

监听器的默认限制的数量，仅用于兼容

1EventEmitter.setMaxListeners(Integer n);

调用参数:

n: Integer, 指定事件的数量

getMaxListeners

获取监听器的默认限制的数量，仅用于兼容

1Integer EventEmitter.getMaxListeners();

返回结果:

Integer, 返回默认限制数量

listeners

查询对象指定事件的监听器数组

1
Array EventEmitter.listeners(String ev);

调用参数:

ev: String, 指定事件的名称

返回结果:

Array, 返回指定事件的监听器数组

listenerCount

查询对象指定事件的监听器数量

1
Integer EventEmitter.listenerCount(String ev);

调用参数:

ev: String, 指定事件的名称

返回结果:

Integer, 返回指定事件的监听器数量

查询对象指定事件的监听器数量

1
2Integer EventEmitter.listenerCount(Value o,
    String ev);

调用参数:

o: Value, 指定查询的对象
ev: String, 指定事件的名称

返回结果:

Integer, 返回指定事件的监听器数量

eventNames

查询监听器事件名称

1
Array EventEmitter.eventNames();

返回结果:

Array, 返回事件名称数组

emit

主动触发一个事件

1
2
Boolean EventEmitter.emit(String ev,
    ...args);

调用参数:

ev: String, 事件名称
args: ..., 事件参数，将会传递给事件处理函数

返回结果:

Boolean, 返回事件触发状态，有响应事件返回 true，否则返回 false

toString

返回对象的字符串表示，一般返回 "[Native Object]"，对象可以根据自己的特性重新实现

1
String EventEmitter.toString();

返回结果:

String, 返回对象的字符串表示

toJSON

返回对象的 JSON 格式表示，一般返回对象定义的可读属性集合

1
Value EventEmitter.toJSON(String key = "");

调用参数:

key: String, 未使用

返回结果:

Value, 返回包含可 JSON 序列化的值

开发指南

基础模块

内置对象

社区模块

对象 EventEmitter

继承关系

构造函数

EventEmitter

对象

静态属性

defaultMaxListeners

成员函数

on

addListener

prependListener

once

prependOnceListener

off

removeListener

removeAllListeners

setMaxListeners

getMaxListeners

listeners

listenerCount

eventNames

emit

toString

toJSON