EventEmitter とは何で、どのように使われますか？

Question

Accepted Answer

**EventEmitter** は、**publish/subscribe**（発行/購読）パターンを実装した Node のコアクラスです。オブジェクトが名前付きのイベントを emit し、それらのイベントに登録されたリスナーが発火時に実行されます。Node 自身の API の多く（stream、HTTP サーバー、process）がこれを基に構築されています。

## 基本的な使い方

```js
import { EventEmitter } from "events";

const emitter = new EventEmitter();

// SUBSCRIBE: イベントにリスナーを登録する
emitter.on("order", (order) => {
  console.log(`Processing order ${order.id}`);
});

// PUBLISH: イベントを emit する（任意のデータ付き）
emitter.emit("order", { id: 123 }); // → "Processing order 123"
```

パターンは次のとおりです。`on(event, listener)` で購読し、`emit(event, ...args)` でそのイベントのすべてのリスナーを同期的にトリガーし、引数を渡します。

## 独自のクラスのために EventEmitter を継承する

```js
class OrderService extends EventEmitter {
  placeOrder(order) {
    // ...注文を保存...
    this.emit("order:created", order);  // 関心のある誰かに通知する
  }
}

const service = new OrderService();
service.on("order:created", (o) => sendEmail(o));   // 疎結合なリスナー
service.on("order:created", (o) => updateAnalytics(o));
service.placeOrder({ id: 1 }); // 両方のリスナーが実行される
```

これにより emitter とそのリスナーが疎結合になります — `OrderService` は誰がリッスンしているかを知らず気にもしないため、それを変更することなくリアクション（メール、analytics、ロギング）を追加できます。

## 便利なメソッド

```js
emitter.once("ready", fn);          // リスナーは一度だけ実行され、その後自動削除される
emitter.off("order", fn);           // リスナーを削除する（リーク防止）
emitter.emit("error", new Error()); // "error" は特別 — リスナーがないと throw する！
emitter.listenerCount("order");
```

## 2 つの重要な落とし穴

```text
⚠️ メモリリーク: リスナーの削除忘れ（off/once を使う）。Node は 1 つのイベントに
   10 を超えるリスナーがあると警告する（"possible EventEmitter memory leak"）。
⚠️ "error" イベント: リスナーなしで emit されると、Node は throw しクラッシュする可能性が
   ある — エラーを起こしうる emitter には常にエラーリスナーを付ける（stream！）。
```

## Node 自身での利用箇所

```text
stream（data、end、error イベント）、http.Server（request イベント）、
process（SIGTERM、exit）、ソケット — すべて EventEmitter。
```

## なぜ重要なのか

EventEmitter は Node のイベント駆動アーキテクチャの基盤です — これを理解することで、stream、サーバー、process オブジェクトがどのように動作するか（それらはすべて emitter です）が説明でき、自身のコードでの疎結合なイベントベースの通信のための標準的なツールでもあります。

`on`/`emit`/`once`/`off` の API、リスナーの削除忘れによるメモリリークのリスク、そしてクラッシュを引き起こす特別な `error` イベントを知ることは、Node の API を正しく使うことと、保守しやすいイベント駆動システムを構築することの両方に不可欠です。