【Node.js24.x】EventEmitter::listenerCount()メソッドの使い方

listenerCountメソッドは、Node.jsのEventEmitterクラスのインスタンスに登録されている特定のイベントのリスナー（イベントハンドラ）の数を取得するメソッドです。

EventEmitterは、Node.jsにおける非同期なイベント駆動型プログラミングの中心的な機能であり、アプリケーション内でイベントの発生とそれに対する処理（リスナー）の登録・解除を管理します。アプリケーションが複雑になるにつれて、特定のイベントにどれだけの処理が紐付いているかを把握することが重要になります。

このlistenerCountメソッドは、EventEmitterのインスタンスに対して呼び出され、引数として数をカウントしたいイベントの名前（文字列またはSymbol）を指定します。メソッドが実行されると、指定されたイベントに現在登録されているイベントリスナーの総数が整数値で返されます。

この機能は、アプリケーションのデバッグや監視において非常に有用です。例えば、特定のイベントに対して期待通りの数のリスナーが登録されているかを確認したり、意図しないリスナーの重複登録が発生していないかを検査したりする際に使用します。これにより、イベント処理の過負荷や、逆にイベントが処理されないままになるリスクを事前に把握し、システムの安定性やパフォーマンスを向上させるための手がかりを得ることができます。listenerCountは、イベント駆動型アプリケーションの健全性を維持し、効率的なリソース管理を行う上で重要なツールとなります。

Copy
1const EventEmitter = require('events');
2
3const myEmitter = new EventEmitter();
4myEmitter.on('eventName', () => {});
5myEmitter.on('eventName', () => {});
6
7const listenerCount = EventEmitter.listenerCount(myEmitter, 'eventName');
8// listenerCount の値は 2 となります。

emitter, eventName

• emitter: EventEmitter: イベントを発行する EventEmitter インスタンス
• eventName: string: カウントしたいイベントの名前

number

指定されたイベントリスナーを登録しているリスナー関数の数を返します。