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

_maxListenersプロパティは、Node.jsのEventEmitterクラスのインスタンスが登録できるイベントリスナーの最大数を内部的に保持するプロパティです。EventEmitterは、イベントが発生した際に特定の関数（リスナー）を実行する、Node.jsにおけるイベント駆動プログラミングの基本的な仕組みを提供します。

この_maxListenersプロパティは、単一のEventEmitterインスタンスに過剰な数のリスナーが追加されることを防止し、潜在的なメモリリークやアプリケーションのパフォーマンス低下に対する警告を促す目的で存在します。Node.jsのデフォルト設定では、EventEmitter.defaultMaxListenersという静的プロパティで定義された値が、すべてのEventEmitterインスタンスに初期値として適用されます。

開発者は通常、この_maxListenersプロパティに直接アクセスして値を変更することはありません。代わりに、EventEmitterクラスが提供するsetMaxListeners(n)メソッドを使用して、特定のインスタンスに対するリスナーの最大数を安全に設定することができます。現在の最大数を取得するにはgetMaxListeners()メソッドを使用します。この内部プロパティは、システムが安定して動作し、開発者が意図しない多数のリスナー登録といった問題を早期に発見するための重要なメカニズムとして機能します。

Copy
1const EventEmitter = require('events');
2const myEmitter = new EventEmitter();
3const maxListenersValue = myEmitter._maxListeners;

引数なし

引数はありません

number

_maxListenersプロパティは、このEventEmitterインスタンスで設定されている、リスナーの最大数を表す数値を返します。