EventEmitter 직접 만들기
on·off·emit·once·onAny를 갖춘 경량 EventEmitter를 만들며 Map·Set을 고른 이유, emit 중 변경을 막는 스냅샷, once의 wrapper 패턴을 정리합니다.
Node.js의 EventEmitter는 매우 익숙한 API지만, 실제로 내부를 직접 구현해보면 생각보다 많은 디테일이 숨어 있습니다.
주어진 요구사항에 맞춰 경량 EventEmitter를 직접 만들면서 pub/sub 패턴을 정리했습니다.
EventEmitter가 지켜야 할 요구사항
요구사항
앱 내부에서 여러 컴포넌트가 상태를 공유할 때 pub/sub 패턴이 자주 쓰입니다. Node.js EventEmitter와 비슷하지만 브라우저와 React Native에서도 동작하는 경량 이벤트 버스를 만드는 것이 목표입니다.
스펙은 다음과 같습니다.
on(event, listener)→ unsubscribe 함수 반환: 이벤트를 구독하고, 반환된 함수를 호출하면 구독 해제off(event, listener): 특정 리스너 제거emit(event, ...args): 이벤트 발행. 구독 중인 모든 리스너를 호출하고, 리스너 하나가 throw해도 나머지는 실행once(event, listener): 한 번만 실행되는 리스너 등록onAny(listener): 모든 이벤트를 받는 리스너 등록 (첫 인자로 event명 전달)offAny(listener): onAny로 등록된 리스너 제거listenerCount(event)→ number: 특정 이벤트의 리스너 수 반환removeAllListeners(event?): event를 지정하면 해당 이벤트 리스너 전체, 지정하지 않으면 모든 리스너 제거
제약은 하나입니다. emit 중에 리스너가 추가·제거되어도 현재 emit에는 영향이 없어야 합니다.
뼈대
class EventEmitter {
constructor() {
//TODO
}
on(event, listener) {
//TODO
}
off(event, listener) {
//TODO
}
emit(event, ...args) {
//TODO
}
once(event, listener) {
//TODO
}
onAny(listener) {
//TODO
}
offAny(listener) {
//TODO
}
listenerCount(event) {
//TODO
}
removeAllListeners(event) {
//TODO
}
}
if (typeof module !== 'undefined') module.exports = { EventEmitter };
라이브러리 대신 직접 만들기와 설계 선택
라이브러리를 쓸까, 직접 만들까
이 시리즈는 기능을 직접 만들어 보는 것이 목적이라, 기존 구현을 가져다 쓰지 않고 처음부터 만들었습니다.
리스너 저장소: Object vs Map
이벤트 이름을 key로, 그 이벤트에 등록된 리스너 목록을 value로 관리합니다. 이때 Object 대신 Map을 사용했습니다.
Object로도 구현은 가능하지만 사용성 면에서 한계가 있습니다. size, delete, get 같은 기본 API가 없고, 순회할 때도 prototype 체인을 고려해야 하는 등 추가 처리가 필요합니다.
Map은 이런 기능을 기본으로 제공하기 때문에, 이벤트 버스처럼 동적 key를 다루는 구조에 더 적합하다고 판단했습니다.
리스너 목록: 배열 vs Set
이벤트별 리스너 목록과 onAny 리스너 목록은 Set으로 만들었습니다. 같은 함수가 중복 등록되지 않고, off()를 Set의 delete 한 번으로 끝낼 수 있습니다.
emit 순회: 원본 vs 스냅샷 복사
원본 listeners를 그대로 순회하면 코드는 짧지만, 리스너 안에서 on()·off()를 부르거나 once가 자기 자신을 지우면 순회 중인 Set이 바뀝니다. "emit 중 변경은 현재 emit에 영향이 없어야 한다"는 제약을 지키려고 얕은 복사한 배열을 순회하는 쪽을 골랐습니다.
EventEmitter 단계별 구현
1. 리스너 저장소는 Map으로
먼저 생성자부터 정의합니다.
constructor() {
this.listeners = new Map()
}이벤트 이름을 key로, 리스너 목록을 value로 둡니다. Object 대신 Map을 고른 이유는 트레이드오프에 정리했습니다.
2. on()은 구독 해제 함수를 돌려준다
그다음 본격적으로 on()부터 구현했습니다.
on(event, listener) {
if(!this.listeners.has(event))// 동일한 이벤트가 없는가
{
this.listeners.set(event, new Set()) // 등록된 이벤트가 없으면 등록
}
this.listeners.get(event).add(listener) // 반환된 함수를 호출
return ()=>this.off(event,listener); // 구독 해제
}
이벤트에 등록되는 리스너 목록은 Set으로 만들어 같은 함수가 중복 등록되지 않게 했습니다. 그리고 on()은 리스너 등록에서 끝나지 않고 구독 해제 함수를 바로 반환합니다. 이 함수가 아래에서 구현할 off()를 호출합니다.
off(event, listener) {
this.listeners.get(event)?.delete(listener);
}off()는 간단하게 Set의 delete로 해당 리스너를 지웠습니다.
3. emit()은 리스너 스냅샷을 순회한다
이제 이벤트를 발행하는 emit()입니다. 리스너 하나가 실패해도 나머지가 실행되도록 각 호출을 try/catch로 감쌌습니다.
emit(event, ...args) {
this.listeners.get(event).forEach(fn => {
try{
fn();
}
catch(e){
}
//리스너가 실패해도 나머지 리스너는 실행되기 위한 예외처리
});처음에는 위처럼 만들었는데, emit() 실행 도중 원본 listeners가 수정될 수 있다는 점을 고려하지 못했습니다. 리스너 안에서 on()이나 off()를 부르면 순회 중인 Set이 바뀝니다.
emit(event, ...args) {
const listeners = [...(this.listeners.get(event) ?? [])];
listeners.forEach(fn => {
try{
fn();
}
catch(e){
}
//리스너가 실패해도 나머지 리스너는 실행되기 위한 예외처리
});
그래서 원본 listeners를 얕은 복사한 배열을 순회하도록 바꿨습니다.
4. once()는 wrapper로 자기 자신을 지운다
가장 헷갈렸던 건 once()입니다. "한 번만 실행되는 리스너"라는 요구사항은 단순해 보이지만, 리스너 자기 자신을 언제, 어떻게 제거할지가 핵심이었습니다. 한 번만 실행되는데 on과 off를 어떻게 한 함수에 담지...? 가 고민이었습니다.
once(event, listener) {
const wrapper = (...args)=>{
listener(...args);
this.off(event,wrapper)
}
this.on(event,wrapper);
}해결 방법은 원본 listener를 감싸는 wrapper 함수를 만들어 등록하는 것이었습니다. 이 wrapper는 이벤트가 발생하면:
- 원본 listener를 실행하고
- 자기 자신(wrapper)을 이벤트 목록에서 제거합니다.
즉 once()는 "실행 + 자기 제거 로직을 포함한 클로저 함수"를 등록하는 구조입니다.
5. onAny()와 offAny()
모든 이벤트를 받는 리스너는 별도 저장소에 두고, emit()에서 일반 리스너 다음에 event명을 첫 인자로 넘겨 호출합니다.
constructor() {
this.listeners = new Map();
this.anyListeners = new Set();
}
emit(event, ...args) {
const listeners = [...(this.listeners.get(event) ?? [])];
const anyListeners = [...this.anyListeners];
for(const listener of listeners){
try{
listener(...args);
}
catch(e){
}
}
for(const listener of anyListeners){
try{
listener(event,...args);
}
catch(e){}
}
}
onAny(listener) {
this.anyListeners.add(listener);
}
offAny(listener) {
this.anyListeners.delete(listener);
}
once 다음부터는 어렵지 않았습니다. 모든 이벤트를 받는 리스너는 이벤트별로 나눌 key가 필요 없어서 Set으로 구현했습니다. emit()에 anyListeners 실행 코드를 추가하는 것으로 onAny 구현은 끝났습니다.
6. listenerCount()와 removeAllListeners()
listenerCount(event) {
return this.listeners.get(event)?.size ?? 0;
}
removeAllListeners(event) {
if(event){
return this.listeners.delete(event)
}
this.listeners.clear();
this.anyListeners.clear();
}마지막으로 특정 이벤트에 등록된 리스너 수를 돌려주는 listenerCount()와 리스너를 지우는 removeAllListeners()를 구현했습니다. removeAllListeners()는 event를 넘기면 그 이벤트만 지우도록 옵셔널 인자를 따로 처리했습니다.
실행 결과로 확인하기
채점 테스트
채점 테스트는 모두 통과했습니다.
[ 1. on / emit / off ]
✅ emit이 리스너를 호출한다
✅ emit이 인자를 전달한다
✅ off로 리스너를 제거한다
✅ on이 반환한 함수로 구독 해제된다
✅ 리스너가 없는 이벤트를 emit해도 에러가 없다
[ 2. once ]
✅ once 리스너는 한 번만 실행된다
✅ once 실행 후 listenerCount가 줄어든다
[ 3. onAny / offAny ]
✅ onAny는 모든 이벤트를 받는다
✅ onAny 리스너는 이벤트명을 첫 인자로 받는다
✅ offAny로 리스너가 제거된다
[ 4. 에러 격리 / emit 중 변경 ]
✅ 리스너가 throw해도 나머지 리스너가 실행된다
✅ emit 중에 리스너를 추가해도 현재 emit에 영향 없다
[ 5. listenerCount / removeAllListeners ]
✅ listenerCount가 현재 리스너 수를 반환한다
✅ removeAllListeners(event)로 특정 이벤트 리스너만 제거된다
✅ removeAllListeners()로 모든 리스너가 제거된배운 것
EventEmitter를 직접 구현하면서 이벤트 기반 구조가 어떻게 동작하는지 감각을 얻을 수 있었습니다.
처음에는 Object로도 충분할 거라 생각했는데, 등록과 삭제가 수시로 일어나는 구조에서는 Map과 Set이 코드를 훨씬 단순하게 만들었습니다. 자료구조 선택이 API 설계의 복잡도를 직접 결정한다는 걸 느꼈습니다.
가장 놓치기 쉬웠던 건 실행 중에 상태가 바뀔 수 있다는 점이었습니다. emit 도중의 구독·해제나 once의 자기 제거처럼, 순회하는 동안 목록이 바뀌는 경우를 첫 구현에서는 생각하지 못했습니다. 클로저로 wrapper가 자기 자신을 참조하게 만든 once도 같은 문제를 다루는 방법이었습니다.
같은 주제의 글
동시 실행 제한 큐 직접 만들기
Promise.all처럼 한꺼번에 실행하지 않고 동시에 N개만 실행하는 ConcurrentQueue를 대기열과 실행 카운터로 만들고, pause·resume·clear까지 구현합니다.
4분 읽기#JavaScript디바운스 검색 직접 만들기
AI 의존을 줄이려고 시작한 시리즈의 첫 편입니다. title·tags 검색에 디바운스, Map 캐시, requestId 기반 race condition 방지를 차례로 붙여 SearchEngine을 만듭니다.
5분 읽기#JavaScript