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

defaultMaxListenersプロパティは、Node.jsのEventEmitterモジュールが管理するイベントに対して、デフォルトで登録できるリスナー（イベントハンドラー）の最大数を保持するプロパティです。

EventEmitterは、特定のイベントが発生した際に実行される関数を登録・管理するための中心的な機能を提供します。アプリケーションの安定性やパフォーマンスを維持するためには、一つのイベントに対して登録されるリスナーの数を適切に管理することが重要です。無制限にリスナーを登録してしまうと、メモリリークの原因となったり、予期せぬ処理の多重実行によりシステム負荷が増大したりする可能性があります。

このプロパティが持つ値は、そうした問題を防ぐための安全弁として機能し、すべてのEventEmitterインスタンスに適用されるデフォルトの上限値を表します。通常、この値は10に設定されています。

もし、あるイベントに登録されたリスナーの数がこのdefaultMaxListenersプロパティの値を超過した場合、Node.jsは開発者に対して警告メッセージを出力します。これはプログラムの実行を中断させるエラーではありませんが、潜在的な問題の兆候である可能性を示唆しており、登録されているリスナーの数を見直すきっかけとなります。

個別のEventEmitterインスタンスにおいては、emitter.setMaxListeners()メソッドを使って、このデフォルト値とは異なる最大リスナー数を個別に設定することが可能です。このプロパティを理解し、適切に管理することは、堅牢で効率的なNode.jsアプリケーションを開発する上で不可欠です。

Copy
1const EventEmitter = require('events');
2
3// 全てのEventEmitterインスタンスのデフォルトの最大リスナー数を設定します。
4EventEmitter.defaultMaxListeners = 15;
5
6// 現在のデフォルトの最大リスナー数を取得します。
7const currentDefaultMaxListeners = EventEmitter.defaultMaxListeners;

引数なし

引数はありません

number

EventEmitterインスタンスが、リスナーの最大数を超えた場合に警告を発するまでのリスナー数のデフォルト値です。