PerformanceResourceTiming: transferSize 屬性
注意：此功能在 Web Workers 中可用。
transferSize 只讀屬性表示已獲取資源的 (以八位位元組為單位的) 大小。此大小包括響應頭欄位以及響應載荷主體 (由 RFC7230 定義)。
如果資源是從本地快取獲取的，或者它是跨域資源，則此屬性將返回零。
值
transferSize 屬性可能具有以下值
- 一個數字，表示已獲取資源的 (以八位位元組為單位的) 大小。此大小包括響應頭欄位以及 響應載荷主體 (RFC7230)。
- 如果資源是從快取中即時檢索的，則為
0。 - 如果資源是跨域請求且未使用
Timing-Allow-OriginHTTP 響應頭，則返回0。
示例
檢查快取是否命中
對於不支援 responseStatus 屬性的環境，可以使用 transferSize 屬性來確定快取命中。如果 transferSize 為零，並且資源具有非零的已解碼主體大小 (意味著資源是同域的或具有 Timing-Allow-Origin)，則該資源是從本地快取獲取的。
使用 PerformanceObserver 的示例，它會在瀏覽器效能時間線中記錄新的 resource 效能條目時通知。使用 buffered 選項可以訪問觀察者建立之前的條目。
js
const observer = new PerformanceObserver((list) => {
list.getEntries().forEach((entry) => {
if (entry.transferSize === 0 && entry.decodedBodySize > 0) {
console.log(`${entry.name} was loaded from cache`);
}
});
});
observer.observe({ type: "resource", buffered: true });
使用 Performance.getEntriesByType() 的示例，它只顯示在呼叫此方法時瀏覽器效能時間線中存在的 resource 效能條目
js
const resources = performance.getEntriesByType("resource");
resources.forEach((entry) => {
if (entry.transferSize === 0 && entry.decodedBodySize > 0) {
console.log(`${entry.name} was loaded from cache`);
}
});
跨域內容大小資訊
如果 transferSize 屬性的值為 0 且不是從本地快取載入的，則該資源可能是跨域請求。要公開跨域內容大小資訊，需要設定 Timing-Allow-Origin HTTP 響應頭。
例如，要允許 https://mdn.club.tw 檢視內容大小，跨域資源應傳送
http
Timing-Allow-Origin: https://mdn.club.tw
規範
| 規範 |
|---|
| 資源時序 # dom-performanceresourcetiming-transfersize |
瀏覽器相容性
載入中…