EventEmitter란 무엇이며 어떻게 사용하나요?

Question

Accepted Answer

**EventEmitter**는 **발행/구독(publish/subscribe)** 패턴을 구현하는 Node의 핵심 클래스입니다. 객체가 이름이 붙은 이벤트를 emit하면, 해당 이벤트에 등록된 listener가 발생 시 실행됩니다. Node 자체 API의 상당 부분(stream, HTTP 서버, process)이 이 위에 구축되어 있습니다.

## 기본 사용법

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

const emitter = new EventEmitter();

// SUBSCRIBE: register a listener for an event
emitter.on("order", (order) => {
  console.log(`Processing order ${order.id}`);
});

// PUBLISH: emit the event (with optional data)
emitter.emit("order", { id: 123 }); // → "Processing order 123"
```

패턴: `on(event, listener)`는 구독하고, `emit(event, ...args)`는 해당 이벤트의 모든 listener를 동기적으로 실행하며 인자를 전달합니다.

## 직접 만든 클래스에서 EventEmitter 확장하기

```js
class OrderService extends EventEmitter {
  placeOrder(order) {
    // ...save the order...
    this.emit("order:created", order);  // notify anyone interested
  }
}

const service = new OrderService();
service.on("order:created", (o) => sendEmail(o));   // decoupled listeners
service.on("order:created", (o) => updateAnalytics(o));
service.placeOrder({ id: 1 }); // both listeners run
```

이는 emitter를 listener로부터 분리합니다. `OrderService`는 누가 듣고 있는지 알지도, 신경 쓰지도 않으므로 이를 수정하지 않고 반응(이메일, 분석, 로깅)을 추가할 수 있습니다.

## 유용한 메서드

```js
emitter.once("ready", fn);          // listener runs only ONCE, then auto-removes
emitter.off("order", fn);           // remove a listener (prevent leaks)
emitter.emit("error", new Error()); // "error" is special — throws if no listener!
emitter.listenerCount("order");
```

## 두 가지 중요한 함정

```text
⚠️ Memory leaks: forgetting to remove listeners (use off/once). Node warns at >10
   listeners on one event ("possible EventEmitter memory leak").
⚠️ The "error" event: if emitted with no listener, Node THROWS and may crash —
   always attach an error listener to emitters that can error (streams!).
```

## Node 자체에서 사용되는 곳

```text
streams (data, end, error events), http.Server (request event),
process (SIGTERM, exit), sockets — all are EventEmitters.
```

## 왜 중요한가

EventEmitter는 Node 이벤트 기반 아키텍처의 기초입니다. 이를 이해하면 stream, 서버, process 객체가 어떻게 동작하는지(모두 emitter입니다) 설명할 수 있으며, 여러분의 코드에서 분리된 이벤트 기반 통신을 위한 표준 도구입니다.

`on`/`emit`/`once`/`off` API, 제거되지 않은 listener로 인한 메모리 누수 위험, 충돌을 일으키는 특수한 `error` 이벤트를 아는 것은 Node API를 올바르게 사용하고 유지보수 가능한 이벤트 기반 시스템을 구축하는 데 필수적입니다.