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

getMaxListenersメソッドは、EventEmitterインスタンスに現在設定されているイベントリスナーの最大数を取得するメソッドです。EventEmitterは、特定のイベントが発生した際に実行されるコールバック関数（イベントリスナー）を登録し、管理するための基本的な機能を提供します。

しかし、一つのイベントに対して無制限に多くのリスナーを追加してしまうと、メモリの使用量が増えすぎたり、イベントが発行されるたびに多くの処理が実行されてアプリケーションのパフォーマンスが低下したりするなど、予期せぬ問題が発生する可能性があります。Node.jsでは、このような潜在的な問題を防ぐため、EventEmitterインスタンスが保持できるイベントリスナーのデフォルトの最大数を10に設定しています。

getMaxListenersメソッドを使用することで、開発者は現在このEventEmitterインスタンスに設定されている明示的な最大値、またはデフォルトの10という値を確認できます。この上限値は、必要に応じてsetMaxListenersメソッドを用いて変更することも可能です。アプリケーションが意図せず多数のリスナーを登録していないかを確認したり、デバッグ時やパフォーマンスチューニングの際に、現在の設定値を知りたい場合にこのメソッドが役立ち、安定したアプリケーションの動作を維持しやすくなります。

Copy
1const EventEmitter = require('events');
2const myEmitter = new EventEmitter();
3
4// 現在の最大リスナー数を取得
5const maxListeners = myEmitter.getMaxListeners();
6console.log(`設定されている最大リスナー数: ${maxListeners}`);

引数なし

引数はありません

number

EventEmitterインスタンスで設定されている、イベントリスナーの最大数を返します。この値は、リスナーが多すぎることによる警告を抑制するために使用されます。