Resource timing
clearResourceTimings() メソッドは、entryType が "resource" のすべてのパフォーマンス項目をブラウザーのパフォーマンスタイムラインから削除し、パフォーマンスリソースデータバッファーのサイズをゼロに設定します。
ブラウザーのリソースデータバッファーのサイズを設定するには、Performance.setResourceTimingBufferSize() メソッドを使用してください。
ブラウザーのリソースタイミングバッファーがいっぱいになったときに通知を取得するには、 resourcetimingbufferfull イベントを待ち受けしてください。
対応ブラウザ
| 機能 | デスクトップ | モバイル | ||||
|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Safari | Chrome Android | Safari iOS | |
| 29 | 12 | 35 | 11 | 29 | 11 | |
| clearResourceTimings() メソッドは、PerformanceEntry.entryType が "resource" のすべてのパフォーマンス項目をブラウザーのパフォーマンスタイムラインから削除し、パフォーマンスリソースデータバッファーのサイズをゼロに設定します。 | 46 | 12 | 35 | 11 | 46 | 11 |
| resourcetimingbufferfull イベントは、ブラウザーのリソースタイミングバッファーがいっぱいになると発生します。 | 46 | 79 | 35 | 11 | 46 | 11 |
| setResourceTimingBufferSize() メソッドは、 "resource" パフォーマンス項目を格納するブラウザーリソースタイミングバッファーの希望するサイズを設定します。 | 46 | 12 | 35 | 11 | 46 | 11 |
| connectEnd は読み取り専用プロパティで、ブラウザーがリソースを取得するためにサーバーへの接続を確立し終わった直後の DOMHighResTimeStamp を返します。このタイムスタンプ値には、トランスポート接続を確立するための時間、TLS ハンドシェイクや SOCKS 認証などの他の時間が含まれます。 | 43 | 12 | 35 | 11 | 43 | 11 |
| connectStart は読み取り専用プロパティで、リソースを取得するためにユーザーエージェントがサーバーへの接続の確立を開始する直前の DOMHighResTimeStamp を返します。 | 43 | 12 | 35 | 11 | 43 | 11 |
| PerformanceResourceTiming インターフェースの read-only プロパティである contentType は、取得されたリソースのコンテンツタイプを示す文字列であり、MIME タイプとサブタイプをスラッシュで区切った形式で表されます。 | 148 | 148 | 129 | | 148 | |
| `deliveryType` 読み取り専用プロパティは、リソースがどのように配信されたかを示す文字列です。たとえば、キャッシュから配信されたか、ナビゲーションによるプリフェッチから配信されたかなどが該当します。 | 117 | 117 | | 26.4 | 117 | 26.4 |
| domainLookupEnd は読み取り専用プロパティで、ブラウザーがリソースのドメイン名検索を終了した直後の DOMHighResTimeStamp を返します。 | 43 | 12 | 35 | 11 | 43 | 11 |
| domainLookupStart は読み取り専用プロパティで、ブラウザーがリソースのドメイン名検索を開始する直前の DOMHighResTimeStamp を返します。 | 43 | 12 | 35 | 11 | 43 | 11 |
| fetchStart は読み取り専用プロパティで、ブラウザーがリソースの取得を開始する直前の DOMHighResTimeStamp を表します。 | 43 | 12 | 35 | 11 | 43 | 11 |
| read-only プロパティ `firstInterimResponseStart` は、ブラウザがサーバーから暫定的な 1xx レスポンス(例:`401` など)の最初のバイトを受信した直後に、`DOMHighResTimeStamp` を返します。 | 115 | 115 | | 26.4 | 115 | 26.4 |
| initiatorType は読み取り専用プロパティで、リソースの読み込みを開始したウェブプラットフォームの機能を表す文字列です。 | 43 | 12 | 35 | 11 | 43 | 11 |
| nextHopProtocol は読み取り専用プロパティで、リソースを取得するために使用されるネットワークプロトコルを表す ALPN プロトコル ID (RFC7301) で識別される文字列です。 | 61 | 17 | 45 | 11 | 61 | 11 |
| redirectEnd は読み取り専用プロパティで、最後のリダイレクトのレスポンスの最後のバイトを受信した直後に DOMHighResTimeStamp を返します。 | 43 | 12 | 35 | 11 | 43 | 11 |
| redirectStart は読み取り専用プロパティで、リダイレクトを開始するフェッチの開始時間を表す DOMHighResTimeStamp を返します。 | 43 | 12 | 35 | 11 | 43 | 11 |
| renderBlockingStatus は読み取り専用のプロパティで、リソースのレンダーブロッキング状態を返します。 | 107 | 107 | | | 107 | |
| requestStart は読み取り専用プロパティで、ブラウザーがサーバー、キャッシュ、またはローカルリソースにリソースのリクエストを開始する直前の DOMHighResTimeStamp を返します。トランスポート接続が失敗してブラウザーがリクエストを再試行した場合、返される値は再試行されたリクエストの開始時刻になります。 | 43 | 12 | 35 | 11 | 43 | 11 |
| responseEnd は読み取り専用プロパティで、ブラウザーがリソースの最後のバイトを受信した直後、または転送接続が閉じられる直前のどちらか早い方の DOMHighResTimeStamp を返します。 | 43 | 12 | 35 | 11 | 43 | 11 |
| responseStart は読み取り専用プロパティで、ブラウザーがサーバー、キャッシュ、またはローカルリソースからレスポンスの最初のバイトを受信した直後の DOMHighResTimeStamp を返します。 | 43 | 12 | 35 | 11 | 43 | 11 |
| responseStatus は読み取り専用のプロパティで、リソースを読み取る際に返される HTTP レスポンスステータスコードを表します。 | 109 | 109 | 129 | | 109 | |
| secureConnectionStart は読み取り専用プロパティで、現在の接続を保護するためにブラウザーがハンドシェイクプロセスを開始する直前に DOMHighResTimeStamp を返します。安全な接続が使用されていない場合、このプロパティはゼロを返します。 | 43 | 18 | 35 | 11 | 43 | 11 |
| toJSON() は PerformanceResourceTiming インターフェイスのメソッドでSerializationです。この PerformanceResourceTiming オブジェクトの JSON 表現を返します。 | 45 | 16 | 35 | 11 | 45 | 11 |
worker_support 労働者で利用可能 | 43 | 15 | 60 | 12 | 43 | |
| workerStart は PerformanceResourceTiming インターフェイスの読み取り専用プロパティで、サービスワーカーのスレッドが既に実行されている場合は FetchEvent を送出する直前、またはサービスワーカーのスレッドがまだ実行されていない場合は、開始される直前に DOMHighResTimeStamp を返します。このリソースがサービスワーカーに介入されない場合、このプロパティは常に 0 を返します。 | 46 | 16 | 58 | 11 | 46 | 11 |
- このバージョンで機能が削除されました (57)
- ベンダープレフィックス付きで対応: webkit (22)
- このバージョンで機能が削除されました (57)
- ベンダープレフィックス付きで対応: webkit (25)
- このバージョンで機能が削除されました (57)
- ベンダープレフィックス付きで対応: webkit (22)
- このバージョンで機能が削除されました (57)
- ベンダープレフィックス付きで対応: webkit (25)
- このバージョンで機能が削除されました (57)
- ベンダープレフィックス付きで対応: webkit (22)
- このバージョンで機能が削除されました (57)
- ベンダープレフィックス付きで対応: webkit (25)
基本構文
clearResourceTimings() 実務での使いどころ
-
Resource timing の活用
clearResourceTimings() メソッドは、entryType が "resource" のすべてのパフォーマンス項目をブラウザーのパフォーマンスタイムラインから削除し、パフォーマンスリソースデータバッファーのサイズをゼロに設定します。
注意点
- 古いブラウザでは対応していない場合がある。
実装メモ
- 一部の API はセキュアコンテキスト (HTTPS) やユーザー操作起点を必要とする。利用前に要件を確認すること。