【Node.js24.x】EventEmitter::_eventsプロパティの使い方

_eventsプロパティは、Node.jsのEventEmitterクラスに属する内部的なプロパティです。このプロパティは、EventEmitterインスタンスに登録されたすべてのイベントとそのリスナー関数（イベントハンドラ）を管理するための情報を保持しています。

具体的には、イベント名（文字列）をキーとして、そのイベントに関連付けられたリスナー関数を値としてマッピングしたオブジェクトやマップのようなデータ構造でイベント情報を保持しています。通常、システムエンジニアを目指す開発者がEventEmitterを利用してイベント駆動プログラミングを行う際、この_eventsプロパティに直接アクセスしたり、内容を操作したりすることはありません。

EventEmitterクラスが提供するon()やaddListener()といったメソッドは、イベントリスナーを追加する際に、この_eventsプロパティ内部にその情報を記録します。また、emit()メソッドで特定のイベントを発行する際には、_eventsプロパティから該当するイベントに登録されたリスナーを探し出し、それらを実行します。

このように、_eventsプロパティはEventEmitterのイベント管理機能の核心部分を担っていますが、これはEventEmitterの内部実装の詳細であり、Node.jsの将来のバージョンでその構造が変更される可能性があります。そのため、安定したアプリケーションを開発するためには、on(), emit()などのEventEmitterが公開しているAPIを利用することが強く推奨されており、_eventsプロパティに直接依存するコードは避けるべきです。このプロパティは、EventEmitterがイベント駆動モデルを効果的に機能させるための重要な内部コンポーネントとして存在しています。

const EventEmitter = require('events');
const myEmitter = new EventEmitter();

myEmitter.on('greet', () => console.log('Hello!'));
myEmitter.on('data', (payload) => console.log('Received data:', payload));

console.log(myEmitter._events);

引数なし

引数はありません

object

EventEmitterクラスの_eventsプロパティは、登録されているイベントリスナーを格納したオブジェクトを返します。このオブジェクトには、イベント名とそれに関連付けられたコールバック関数の配列が格納されています。