PerformanceResourceTiming.requestStart
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2017年9月.
requestStart は読み取り専用プロパティで、ブラウザーがサーバー、キャッシュ、またはローカルリソースにリソースのリクエストを開始する直前の timestamp を返します。トランスポート接続が失敗してブラウザーがリクエストを終了すると、返される値は再試行要求の開始になります。
requestStart には end プロパティはありません。リクエスト時間を計測するには、 responseStart - requestStart を計算してください（下記の例を参照してください）。
値
requestStart プロパティは以下の値を取ります。
- ブラウザーがサーバーからリソースのリクエストを始める直前の時刻を表す
DOMHighResTimeStampです。 - リソースがキャッシュから即座に取得された場合は
0です。 - リソースがオリジン間リクエストで取得され、HTTP の
Timing-Allow-Originレスポンスヘッダーが使用されなかった場合は0となります。
例
リクエスト時間の計測
requestStart と responseStart プロパティを使用して、リクエストにかかる時間を測定することができます。
const request = entry.responseStart - entry.requestStart;
PerformanceObserver を使用した例です。このオブジェクトは、新しい resource パフォーマンス項目がブラウザーのパフォーマンスタイムラインに記録されると、それを通知します。オブザーバーが作成される前の項目にアクセスするために buffered オプションを使用します。
const observer = new PerformanceObserver((list) => {
list.getEntries().forEach((entry) => {
const request = entry.responseStart - entry.requestStart;
if (request > 0) {
console.log(`${entry.name}: Request time: ${request}ms`);
}
});
});
observer.observe({ type: "resource", buffered: true });
Performance.getEntriesByType() を使用した例です。このメソッドを呼び出した時点でブラウザー上のパフォーマンスタイムラインに存在する resource パフォーマンス項目のみを表示します。
const resources = performance.getEntriesByType("resource");
resources.forEach((entry) => {
const request = entry.responseStart - entry.requestStart;
if (request > 0) {
console.log(`${entry.name}: Request time: ${request}ms`);
}
});
オリジン間のタイミング情報
requestStart プロパティの値が 0 である場合、そのリソースはオリジン間リクエストである可能性があります。オリジン間のタイミング情報を見るためには、Timing-Allow-Origin HTTP レスポンスヘッダーを設定する必要があります。
例えば、https://newreal1.mobosoft.fun にタイミングリソースを見ることを許可するには、オリジン間リソースが送信する必要があります。
Timing-Allow-Origin: https://newreal1.mobosoft.fun
仕様書
| Specification |
|---|
| Resource Timing # dom-performanceresourcetiming-requeststart |
ブラウザーの互換性
Loading…