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

getEventListenersメソッドは、Node.jsのEventEmitterクラスに属し、特定のイベントに登録されている全てのリスナー関数を取得するメソッドです。このメソッドは、EventEmitterのインスタンスに対して呼び出すことで、指定されたイベント名に関連付けられている現在のリスナーの状態を確認することができます。

具体的には、第一引数に確認したいイベントのeventName（イベントの名前を表す文字列またはsymbol）を渡すと、そのイベントに対して登録されているリスナー関数を要素として含む配列を返します。もし、そのイベントに対してリスナーが一つも登録されていない場合は、空の配列が返されます。

このメソッドは、主にデバッグや、イベントリスナーが期待通りに登録されているか、あるいは意図せず重複して登録されていないかなどをプログラム上で確認したい場合に非常に役立ちます。例えば、アプリケーションの動作中に特定のイベントが正しく処理されるべきか、どのリスナーが応答するかを動的に検証する際に使用できます。getEventListenersメソッドは、EventEmitterが持つイベントハンドリングの透明性を高め、より堅牢なシステム開発を支援します。

Copy
1const EventEmitter = require('events');
2const myEmitter = new EventEmitter();
3
4myEmitter.on('data', () => {
5  // イベントリスナーの処理
6});
7
8const registeredListeners = EventEmitter.getEventListeners(myEmitter, 'data');
9console.log(registeredListeners);

emitter, name

• emitter: EventEmitter: イベントを発行する対象のEventEmitterインスタンス
• name: string: 取得したいイベントリスナーの名前（イベントタイプ）

Function[]

EventEmitterインスタンスに登録されているすべてのリスナー関数を配列で返します。