nodejs中什么是 EventEmitter？

封面图 • 2025-04-28 • nodejs

在 Node.js 中，`EventEmitter` 是一个核心模块中的类，属于 `events` 模块。它提供了一种事件驱动的编程模式，允许对象通过触发和监听事件来实现松耦合的通信。

### 核心概念

1. **事件触发（Emitting Events）**：
   - 使用 `EventEmitter` 的实例方法 `emit()` 来触发一个事件。
   - 你可以为每个事件传递任意数量的参数。

2. **事件监听（Listening to Events）**：
   - 使用 `on()` 或 `addListener()` 方法来监听特定事件。
   - 当事件被触发时，监听器函数会被调用，并接收到触发事件时传递的参数。

3. **事件名称**：
   - 事件名称通常是一个字符串，表示事件的类型。
   - 事件名称是区分大小写的。

4. **回调函数**：
   - 监听器是一个回调函数，当事件被触发时会执行。

---

### 基本用法

以下是一个简单的示例，展示如何使用 `EventEmitter`：

```javascript
const { EventEmitter } = require('events');

// 创建 EventEmitter 的实例
const myEmitter = new EventEmitter();

// 监听事件 'myEvent'
myEmitter.on('myEvent', (arg1, arg2) => {
    console.log('事件触发了！参数：', arg1, arg2);
});

// 触发事件 'myEvent' 并传递参数
myEmitter.emit('myEvent', 'Hello', 'World');
```

输出结果：
```
事件触发了！参数： Hello World
```

---

### 常用方法

1. **`on(event, listener)` / `addListener(event, listener)`**  
   添加一个监听器以响应指定事件。

2. **`once(event, listener)`**  
   添加一个只触发一次的监听器。

3. **`emit(event, [...args])`**  
   触发指定事件，并传递参数。

4. **`removeListener(event, listener)`**  
   移除某个特定的监听器。

5. **`removeAllListeners([event])`**  
   移除所有监听器，或者移除指定事件的所有监听器。

6. **`setMaxListeners(n)`**  
   设置或获取最大监听器的数量，默认值为 10。

7. **`listeners(event)`**  
   返回指定事件的所有监听器数组。

8. **`listenerCount(event)`**  
   返回指定事件的监听器数量。

---

### 示例：多个监听器

```javascript
const { EventEmitter } = require('events');

const myEmitter = new EventEmitter();

// 第一个监听器
myEmitter.on('myEvent', () => {
    console.log('监听器 1 触发');
});

// 第二个监听器
myEmitter.on('myEvent', () => {
    console.log('监听器 2 触发');
});

// 触发事件
myEmitter.emit('myEvent');
```

输出结果：
```
监听器 1 触发
监听器 2 触发
```

---

### 特殊事件：`error`

在 Node.js 中，`error` 事件是一个特殊的事件。如果未监听 `error` 事件且触发了该事件，Node.js 会抛出异常并退出进程。

```javascript
const { EventEmitter } = require('events');

const myEmitter = new EventEmitter();

// 触发 error 事件
myEmitter.emit('error', new Error('Something went wrong'));

// 正确的做法是监听 error 事件
myEmitter.on('error', (err) => {
    console.error('Error caught:', err.message);
});
```

---

### 实际应用场景

- **日志系统**：记录事件的发生。
- **异步任务管理**：例如文件读取完成、网络请求成功等。
- **插件系统**：模块之间通过事件进行交互。
- **WebSocket**：客户端与服务器之间的消息传递。

---

总结来说，`EventEmitter` 是 Node.js 中实现事件驱动编程的重要工具，广泛应用于各种场景中。它通过事件机制实现了对象间的解耦，使代码更加灵活和易于维护。