미리보기를 열고 닫은 뒤 다시 엽니다. 다음 업데이트에서 콜백이 두 번 호출됩니다. 앱을 다시 실행하면 괜찮아지지만 같은 순서로 조작하면 문제가 돌아옵니다. 이벤트를 보내는 코드를 바꾸기 전에 첫 미리보기가 무엇을 남겼는지 살펴보세요.

여러 미리보기가 각 뷰보다 오래 유지되는 이벤트 버스를 공유한다고 가정해 봅시다. 작은 Node.js 예제로 창을 그리지 않고 열기와 닫기를 재현할 수 있습니다. 각 단계 뒤에 어떤 구독이 남아 있는지가 핵심입니다.

다시 열기 전후의 구독 수를 세기

다시 연 뒤 change를 한 번만 발생시킵니다. 리스너 수와 업데이트를 받은 뷰를 함께 기록합니다.

단계 잘못된 구현의 리스너 수 수정한 구현의 리스너 수
열기 전 0 0
첫 번째 뷰 열기 1 1
첫 번째 뷰 닫기 1 0
두 번째 뷰 열기 2 1
이벤트 한 번 발생 두 뷰 모두 수신 두 번째 뷰만 수신

처음 의심할 지점은 첫 번째 뷰를 닫는 단계입니다. 여기서 구독이 사라져야 합니다. 업데이트 핸들러만 읽으면 앞서 발생한 실수를 놓칩니다.

예제는 listenerCount('change')로 수를 확인하고 emit으로 콜백을 동기 호출합니다. 타이머나 반복 클릭 없이도 중복 전달을 재현할 수 있습니다.

함수의 모양이 아니라 참조를 따라가기

아래 마운트 함수에는 문제가 있습니다. 반환하는 함수는 호출자가 뷰를 닫을 때 실행해야 합니다.

export function mountUnsafeView(bus, publish) {
  bus.on('change', (value) => publish(value));
  return () => bus.off('change', (value) => publish(value));
}

on과 off에 전달한 화살표 함수는 똑같아 보이지만, 각 표현식을 평가할 때 별개의 함수 객체가 만들어집니다. 정리 과정에서는 새 객체를 찾으므로 원래 구독이 그대로 남습니다. 첫 콜백은 처음 받은 게시 함수에도 계속 접근할 수 있습니다.

Node에서 off는 지정한 리스너를 제거하는 removeListener의 별칭입니다. 이 규칙은 Events API 문서에서 확인할 수 있습니다. 이 EventEmitter 예제에서는 이벤트 이름과 콜백 본문이 같다는 것만으로 부족합니다. 등록할 때 사용한 함수 참조가 필요합니다.

마운트마다 자신의 정리 함수 반환하기

콜백을 한 번 저장하고, 정리 클로저가 같은 참조를 보관하게 합니다.

export function mountView(bus, publish) {
  const onChange = (value) => publish(value);
  bus.on('change', onChange);
  let disposed = false;
  return function dispose() {
    if (disposed) return;
    disposed = true;
    bus.off('change', onChange);
  };
}

마운트할 때마다 고유한 onChange를 만듭니다. 반환된 dispose는 해당 마운트의 구독을 제거하고 이후 호출에서는 아무 일도 하지 않습니다. 플래그는 반복 정리의 동작을 명확히 하고, 별개의 콜백 참조는 마운트를 서로 구분합니다.

두 뷰가 동일한 publish 함수를 받아도 마운트마다 래퍼를 만들기 때문에 구독은 분리됩니다. 두 뷰가 publish를 그대로 on에 넘기면 같은 함수가 두 번 등록되고, off 한 번으로는 하나만 제거됩니다. 마지막 재현 테스트가 이 경우를 보여 줍니다. 정리 함수는 이를 만든 뷰와 함께 보관해야 합니다. 닫기 전에 버리거나 덮어쓰면 수정한 함수도 스스로 구독을 해제할 수 없습니다.

다른 구독자가 있을 때 정리 테스트하기

다른 구독자가 없는 버스에서 뷰를 닫은 후 리스너가 0개인지 확인하는 테스트는 유용하지만 충분하지 않습니다. removeAllListeners로 바꿔도 이 테스트는 통과하며 공유 버스의 다른 소비자까지 업데이트를 받지 못하게 됩니다.

그래서 예제는 독립된 관찰자를 등록하고, 이전 뷰를 열고 닫은 뒤 새 뷰를 엽니다. 이어서 이전 정리 함수를 다시 호출하고 이벤트 수신자를 확인합니다.

확인 시점 필요한 결과
이전 정리를 반복한 뒤 업데이트 관찰자와 새 뷰가 수신
새 뷰를 두 번 닫은 뒤 업데이트 관찰자만 수신
게시 함수를 공유하는 두 뷰 중 하나를 닫음 남은 뷰는 계속 수신
열기와 닫기를 세 번 반복 열 때마다 한 번 수신, 닫은 뒤에는 수신하지 않음

단언은 개수뿐 아니라 실제 전달도 확인합니다. 리스너가 하나 남았다는 사실만으로는 관찰자인지 잘못 남은 뷰인지 알 수 없습니다. 새 마운트 뒤에 이전 dispose를 다시 호출하면 공유된 변경 가능 상태를 잘못 참조하는 정리도 찾아낼 수 있습니다.

실제 호출자에서 종료 경로까지 읽기

낯선 코드를 읽을 때도 같은 순서로 진행합니다.

  1. 이벤트 버스를 만드는 위치에서 화면 이동 뒤에도 살아 있는지, 특정 뷰에만 속하는지 확인합니다.
  2. 모든 구독 위치를 찾고 열기, 렌더링, 재연결로 각각 몇 번 도달하는지 셉니다.
  3. 등록에서 제거까지 정확한 콜백 참조를 따라갑니다.
  4. mountView 호출자가 반환된 함수를 어디에 저장하는지 찾습니다.
  5. 뷰 교체와 초기화 실패를 포함해 관련된 종료 경로에서 dispose 호출까지 따라갑니다.

각 등록 옆에 관리 주체와 종료 위치를 적습니다. 정리 함수가 있지만 호출하지 않는 문제와 잘못된 참조로 호출하는 문제는 수정 방법이 다릅니다. 콜백이 비동기 작업을 시작한다면 그 안까지 따라가세요. 구독 제거는 이미 시작한 작업을 되돌리지 않습니다. 비동기 UI 상태 추적에서 다음 단계를 살펴볼 수 있습니다.

예제 실행과 적용 범위 확인

event-listener-lifecycle.mjs를 다운로드해 Node.js 22 이상에서 실행합니다.

node --test event-listener-lifecycle.mjs

테스트 다섯 개가 모두 통과합니다. 이름에 reproduce:가 붙은 두 테스트는 다시 연 뒤의 구독 잔류와 같은 콜백을 두 번 등록한 후 한 번만 제거했을 때의 잔류를 의도적으로 확인합니다. 나머지 세 개는 정리, 반복 호출, 구독자 간 독립성을 검사합니다. 외부 의존성과 타이머는 필요하지 않습니다.

이 실습은 EventEmitter로 뷰 수명을 모델링합니다. 브라우저를 구현하거나 DOM EventTarget과 같은 동작을 보장하지 않습니다. 마운트마다 한 번 등록하고 이벤트 발생 사이에 제거합니다. 이벤트 처리 중 제거, 프레임워크의 효과 처리, 진행 중인 작업 취소는 실제 API에 맞춰 별도로 확인해야 합니다.

Yenpo에서는 진입점과 정리 파일을 함께 열고 두 곳에 저장된 콜백 참조를 따라가는 것부터 시작하세요.