PerformanceResourceTiming: requestStart 屬性
注意:此功能在 Web Workers 中可用。
requestStart 只讀屬性返回一個 timestamp,表示瀏覽器開始從伺服器、快取或本地資源請求資源的緊前時刻。如果傳輸連線失敗並且瀏覽器重試請求,返回的值將是重試請求的開始時間。
requestStart 沒有“結束”屬性。要測量請求時間,請計算 responseStart - requestStart(參見下方的示例)。
值
requestStart 屬性可以具有以下值
- 一個
DOMHighResTimeStamp,表示瀏覽器開始從伺服器請求資源的緊前時刻。 - 如果資源是從快取中即時檢索的,則為
0。 - 如果資源是跨域請求且未使用
Timing-Allow-OriginHTTP 響應頭,則返回0。
當 firstInterimResponseStart 非零時,表示對於 支援的瀏覽器,它應與 requestStart 的值相同。
當沒有中間響應時,requestStart 與 finalResponseHeadersStart 相同,而 firstInterimResponseStart 為 0。
示例
測量請求時間
requestStart 和 responseStart 屬性可用於測量請求花費的時間。
js
const request = entry.responseStart - entry.requestStart;
使用 PerformanceObserver 的示例,它會在瀏覽器效能時間線中記錄新的 resource 效能條目時通知。使用 buffered 選項可以訪問觀察者建立之前的條目。
js
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 效能條目
js
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://mdn.club.tw 檢視時序資源,跨域資源應傳送
http
Timing-Allow-Origin: https://mdn.club.tw
規範
| 規範 |
|---|
| 資源時序 # dom-performanceresourcetiming-requeststart |
瀏覽器相容性
載入中…