如何捕获 EventEmitter的错误事件？

封面图 • 2025-09-01 • nodejs

在 Node.js 中，`EventEmitter` 是一个基础类，用于处理事件。你可以通过监听 `error` 事件来捕获错误。但是需要注意的是，如果你没有正确地监听 `error` 事件，Node.js 默认会抛出异常并导致程序崩溃。

### 捕获 EventEmitter 的错误事件

#### 1. 基本用法

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

class MyEmitter extends EventEmitter {}

const myEmitter = new MyEmitter();

// 监听 error 事件
myEmitter.on('error', (err) => {
  console.error('捕获到错误:', err.message);
});

// 触发一个错误事件
myEmitter.emit('error', new Error('这是一个错误'));
```

输出：

```
捕获到错误: 这是一个错误
```

#### 2. 在异步代码中使用

如果你在异步函数中触发错误事件，确保你已经监听了 `error` 事件，否则可能会导致未捕获的异常（uncaught exception）。

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

class MyEmitter extends EventEmitter {}

const myEmitter = new MyEmitter();

myEmitter.on('error', (err) => {
  console.error('捕获到错误:', err.message);
});

setTimeout(() => {
  myEmitter.emit('error', new Error('异步错误'));
}, 1000);
```

#### 3. 使用 `once` 监听一次错误事件

如果你想只监听一次错误事件，可以使用 `once` 方法：

```javascript
myEmitter.once('error', (err) => {
  console.error('仅捕获一次错误:', err.message);
});
```

#### 4. 避免未捕获的异常

如果没有监听 `error` 事件，Node.js 会将错误作为未捕获的异常抛出，这会导致程序崩溃。因此，建议总是监听 `error` 事件。

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

const emitter = new EventEmitter();

// 不监听 error 事件
emitter.emit('error', new Error('未捕获的错误'));

// 此时会抛出异常，程序崩溃
```

### 总结

- 使用 `emitter.on('error', callback)` 来捕获 `EventEmitter` 的错误。
- 如果不监听 `error` 事件，错误会变成未捕获的异常，导致程序崩溃。
- 在异步代码中也要确保正确监听 `error` 事件。

如果你使用的是第三方库中的 `EventEmitter` 实例（如 `http`、`fs` 等），它们通常也会触发 `error` 事件，你应该同样监听这些事件以避免程序崩溃。