ナビゲーションおよびリソースタイミング

リクエストされたページの読み込みパフォーマンスを測定する JavaScript API であるパフォーマンスタイミング API は非推奨ですが、すべてのブラウザーで対応しています。これはパフォーマンスナビゲーションタイミング API に置き換えられています。

パフォーマンスタイミング API は、ページ読み込みプロセスの各ポイントにつ達したかを記述する読み取り専用の時刻をミリ秒 (ms) 単位で提供していました。下記画像に表示されているように、ナビゲーションプロセスは navigationStart, unloadEventStart (en-US), unloadEventEnd (en-US), redirectStart (en-US), redirectEnd (en-US), fetchStart, domainLookupStart (en-US), domainLookupEnd (en-US), connectStart (en-US), connectEnd (en-US), secureConnectionStart (en-US), requestStart (en-US), responseStart (en-US), responseEnd (en-US), domLoading (en-US), domInteractive (en-US), domContentLoadedEventStart (en-US), domContentLoadedEventEnd (en-US), domComplete (en-US), loadEventStart (en-US), loadEventEnd (en-US) から成ります。

上記の指標と少しの計算で、最初のバイトまでの時間、ページ読み込み時間、 DNS 参照、安全な接続かどうかなど、多くの重要な指標を計算することができます。

すべての手順を完了するのにかかる時間を測定するのを支援するために、パフォーマンスタイミング API はナビゲーションの時刻の読み取り専用の測定値を提供します。アプリの時刻を表示し、キャプチャするには、次のように入力します。

let time = window.performance.timing;

その結果を使用して、アプリのパフォーマンスを測定することができます。

順序は次の通りです。

これらの値を使用して、関心のある固有のタイミングを測定することができます。

const dns = time.domainLookupEnd - time.domainLookupStart;
const tcp = time.connectEnd - time.connectStart;
const tls = time.requestStart - time.secureConnectionStart;

最初のバイトまでの時間 は、 performanceTiming APIが利用可能な navigationStart （ナビゲーションの開始）から responseStart （レスポンスデータの最初のバイトを受信）までの時間です。

const ttfb = time.responseStart - time.navigationStart;

ページ読み込み時間 は navigationStart から現在の文書の load イベントが始まるまでの時間です。これらはパフォーマンスタイミング API でのみ利用可能です。

let pageloadtime = time.loadEventStart - time.navigationStart;

DNS 参照時間は、 domainLookupStart と domainLookupEnd の間の時間です。これらは performanceTiming と performanceNavigationTiming API の両方で利用可能です。

const dns = time.domainLookupEnd - time.domainLookupStart;

TCP のハンドシェイクにかかる時間は、接続を始めてから終わるまでの時間です。

const tcp = time.connectEnd - time.connectStart;

secureConnectionStart は利用できない場合は undefined、 HTTPS を用いない場合は 0、利用可能で使用した場合はタイムスタンプになります。言い換えれば、安全な接続を使用した場合、 secureConnectionStart は真値になり、 secureConnectionStart から requestStart までの時間は 0 より大きくなります。

const tls = time.requestStart - time.secureConnectionStart;

上記の一般的なパフォーマンスタイミングは非推奨ですが、完全に対応しています。パフォーマンス項目 API が登場し、ナビゲーションやリソースの読み込みプロセスに沿って時刻を指定したり計測したりすることができるようになりました。マークを作成することもできます。

performance.getEntriesByType("navigation").forEach((navigation) => {
  console.dir(navigation);
});

performance.getEntriesByType("resource").forEach((resource) => {
  console.dir(resource);
});

performance.getEntriesByType("mark").forEach((mark) => {
  console.dir(mark);
});

performance.getEntriesByType("measure").forEach((measure) => {
  console.dir(measure);
});

performance.getEntriesByType("paint").forEach((paint) => {
  console.dir(paint);
});

performance.getEntriesByType("frame").forEach((frame) => {
  console.dir(frame);
});

対応しているブラウザーでは、 performance.getEntriesByType('paint') を使用して、 first-paint と first-contentful-paint の測定値を問い合わせることができます。 performance.getEntriesByType('navigation') と performance.getEntriesByType('resource') を使用して、それぞれナビゲーションとリソースの時刻を問い合わせます。

ユーザーがウェブサイトやアプリケーションをリクエストすると、ブラウザーに表示するために、ユーザーエージェントは DNS 参照、 TCP ハンドシェイク、 TLS ネゴシエーションを含む一連の手順を経て、ユーザーエージェントが実際のリクエストを行い、サーバーがリクエストされた資産を返します。その後、ブラウザーは受け取ったコンテンツを解釈し、DOM、CSSOM、アクセシビリティ、レンダリングツリーを構築し、最終的にページをレンダリングします。ユーザーエージェントが文書の解釈をやめると、ユーザーエージェントは文書の準備状態を interactive に設定します。解釈する必要のある遅延スクリプトがある場合は、それを実行し、DOMContentLoaded を発行します。これで文書は読み込み後のタスクを処理できるようになり、この時点で文書は完全に読み込まれたとみなされます。

const navigationTimings = performance.getEntriesByType("navigation");

performance.getEntriesByType('navigation') は、 navigation 型の PerformanceEntry オブジェクトの配列を返します。

このようなタイミングから、多くのことを得ることができます。上の画像では、 name プロパティを通して、時刻を計測しているファイルがこの文書化であることがわかります。 この説明の残りの部分では、以下の変数を使用します。

const timing = performance.getEntriesByType("navigation")[0];

次の問い合わせを使用することで、プロトコルをチェックすることができます。

const protocol = timing.nextHopProtocol;

リソースをフェッチするために使用したネットワークプロトコルを返します。この場合は http/2 のために h2 を返します。

圧縮率を取得するには、 transferSize を decodedBodySize で割り、それを 100% から引きます。 74% 以上が節約されたことが分かります。

const compressionSavings = 1 - timing.transferSize / timing.decodedBodySize;

次のもので計算できます。

const compressionSavings = 1 - timing.encodedBodySize / timing.decodedBodySize;

ただし、 transferSize にはオーバーヘッドのバイトが含まれます。

比較のためにネットワークタブを見てみると、非圧縮で 87.24KB のサイズのファイルを 22.04KB で転送しています。

これらの数値で計算すると、1 - (22.04 / 87.24) = 0.747 という同じ結果が取得されます。ナビゲーションタイミングは、プログラムで転送のサイズと帯域幅の節約を調べる方法を提供します。

これはこの単一の文書のサイズです。つまり、このリソースだけのサイズであり、すべてのリソースを合わせたサイズではないことに注意してください。しかし、所要時間、読み込むイベント、DOM 関連の時刻は、この単一の資産ではなく、ナビゲーション全体に関係しています。クライアント側のウェブアプリケーションは、転送サイズが 10000 以下、デコードする本体サイズが 30000 以下では、これよりも高速に見えるかもしれませんが、JavaScript や CSS、メディア資産が肥大化していないことを意味しているわけではありません。圧縮率を調べることは重要ですが、 DOMContentLoaded イベントが終わってから DOM が完了するまでの時間や期間も確実に調べてください。メインスレッドで JavaScript を長時間実行すると、ユーザーインターフェイスが応答しなくなる可能性があるからです。

APIは、あなたが望むかもしれないすべての測定を提供するわけではありません。例えば、リクエストにかかった時間は？答えを得るために、ある測定値を使用することができます。

レスポンスタイムを測定するには、レスポンス開始時刻からリクエスト開始時刻を引きます。リクエスト開始時刻は、ユーザーエージェントがサーバー、関連するアプリケーションキャッシュ、またはローカルリソースからリソースのリクエストを始める直前の時刻です。レスポンス開始時刻は、ユーザーエージェントの HTTP パーサーが、関連するアプリケーションキャッシュから、あるいはローカルリソースから、あるいはサーバーから、レスポンスの最初のバイトを受信した直後の時刻です。

const request = timing.responseStart - timing.requestStart;

現在の文書の load イベントが発生する直前から、現在の文書の load イベントが完全に終了した時刻までのタイムスタンプを引くことで、 load イベントの所要時間を測定することができます。

const load = timing.loadEventEnd - timing.loadEventStart;

DOMContentLoaded イベントの所要時間は、ユーザーエージェントが DOMContentLoaded イベントを発行する直前の時刻値から、イベントが完全に終了した直後の時刻値を引くことによって測定されます。これを 50ms またはそれ以上に保つことで、確実にレスポンスの良いユーザーインターフェイスを保証することに役立ちます。

const DOMContentLoaded =
  timing.domContentLoadedEventEnd - timing.domContentLoadedEventStart;

所要時間があります。所要時間は PerformanceNavigationTiming.loadEventEnd プロパティと PerformanceEntry.startTime プロパティの差です。

PerformanceNavigationTiming インターフェイスは、navigate、reload、back_forward、prerender を返すことで、計測しているナビゲーションの種類に関する情報も提供します。

ナビゲーションタイミングはメインページ（一般に、他のすべての資産がリクエストされた HTML ファイル）のパフォーマンスを測定するのに対し、リソースのタイミングは個々のリソース（メインページから呼び出される資産、およびそれらのリソースがリクエストする資産）のタイミングを測定します。測定の多くは似ています。 DNS 参照、 TCP ハンドシェイク、安全な接続の開始はドメインごとに 1 回ずつ行われます。

主な用途は、それぞれのリソースを見ていくことです。

• PerformanceNavigationTiming
• PerformanceResourceTiming,
• PerformanceMark
• PerformanceMeasure
• PerformancePaintTiming