PerformanceResourceTiming.decodedBodySize
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2023年3月.
decodedBodySize は読み取り専用プロパティで、適用されたコンテンツエンコーディング(gzip や Brotli など)を削除した後、メッセージ本体のフェッチ(HTTP またはキャッシュ)で受信したサイズ(オクテット単位)を返します。リソースがアプリケーションキャッシュまたはローカルリソースから取得された場合、適用されたコンテンツコーディングを削除した後でペイロードのサイズを返します。
値
decodedBodySize プロパティは、以下の値を取ります。
- フェッチ(HTTP またはキャッシュ)から受け取ったペイロード本体のサイズ(オクテット単位)を表す数値で、適用されたエンコーディングを削除した後のものです。
- リソースがオリジン間リクエストで、HTTP の
Timing-Allow-Originヘッダーが使用されていない場合は0。
例
>コンテンツが圧縮されているかどうかのチェック
もし decodedBodySize と encodedBodySize プロパティが null でなく異なっていれば、コンテンツは(例えば gzip や Brotli などの)圧縮されたものです。
PerformanceObserver を使用した例です。このオブジェクトは、新しい resource パフォーマンス項目がブラウザーのパフォーマンスタイムラインに記録されると、それを通知します。オブザーバーが作成される前の項目にアクセスするために buffered オプションを使用します。
const observer = new PerformanceObserver((list) => {
list.getEntries().forEach((entry) => {
const uncompressed =
entry.decodedBodySize && entry.decodedBodySize === entry.encodedBodySize;
if (uncompressed) {
console.log(`${entry.name} was not compressed!`);
}
});
});
observer.observe({ type: "resource", buffered: true });
Performance.getEntriesByType() を使用した例です。このメソッドを呼び出した時点でブラウザー上のパフォーマンスタイムラインに存在する resource パフォーマンス項目のみを表示します。
const resources = performance.getEntriesByType("resource");
resources.forEach((entry) => {
const uncompressed =
entry.decodedBodySize && entry.decodedBodySize === entry.encodedBodySize;
if (uncompressed) {
console.log(`${entry.name} was not compressed!`);
}
});
オリジン間のコンテンツサイズ情報
decodedBodySize プロパティの値が 0 である場合、そのリソースはオリジン間リクエストである可能性があります。オリジン間のタイミング情報を見るためには、HTTP の Timing-Allow-Origin レスポンスヘッダーを設定する必要があります。
例えば、https://big.rakal.top にタイミングリソースを見ることを許可するには、オリジン間リソースで次のものを送信する必要があります。
Timing-Allow-Origin: https://big.rakal.top
仕様書
| Specification |
|---|
| Resource Timing> # dom-performanceresourcetiming-decodedbodysize> |
ブラウザーの互換性
Loading…