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

PerformanceObserverEntryListメソッドは、PerformanceObserverによって収集されたパフォーマンスデータのエントリーリストへのアクセスを管理し、提供するメソッドです。これは、Node.jsアプリケーションやWeb環境におけるパフォーマンス監視において中心的な役割を果たします。PerformanceObserverのインスタンスが特定のイベントを監視し、その結果としてパフォーマンスエントリーが収集されると、このPerformanceObserverEntryListオブジェクトがコールバック関数に引数として渡されます。

開発者は、このPerformanceObserverEntryListが提供するいくつかのメソッドを利用して、関心のあるパフォーマンスデータを効率的に取得できます。具体的には、getEntries()メソッドで全てのパフォーマンスエントリーを取得したり、getEntriesByType(type)メソッドで特定のタイプ（例えば、'resource'や'mark'など）のエントリーをフィルタリングして取得したり、getEntriesByName(name, type)メソッドで特定の名前とタイプに一致するエントリーを取得したりできます。

これにより、アプリケーションの起動時間、リソースの読み込み時間、スクリプトの実行時間、または開発者が任意に設定したカスタムのパフォーマンスマークといった詳細な測定データにアクセスすることが可能です。これらの情報を分析することで、アプリケーションのボトルネックを特定し、パフォーマンス改善のための具体的な最適化ポイントを見つけ出すことができます。Node.jsではperf_hooksモジュールを通じて、この強力なパフォーマンス監視機能を利用することが可能です。

Copy
1const { PerformanceObserver } = require('node:perf_hooks');
2
3const observer = new PerformanceObserver((list, obs) => {
4  const allEntries = list.getEntries();
5  const measureEntries = list.getEntriesByType('measure');
6  const specificNamedEntries = list.getEntriesByName('my-operation');
7});

引数なし

引数はありません

PerformanceObserverEntryList

PerformanceObserverEntryListは、パフォーマンス計測の記録（PerformanceEntry）のリストを表すオブジェクトです。このリストは、計測されたパフォーマンスイベントを収集・管理するために使用されます。