PerformanceNavigationTiming

Baseline 廣泛可用 *

此功能已成熟，並且適用於多種裝置和瀏覽器版本。自 2021 年 10 月以來，它已在所有瀏覽器中可用。

* 此特性的某些部分可能存在不同級別的支援。

PerformanceNavigationTiming 介面提供了用於儲存和檢索有關瀏覽器文件導航事件的指標的方法和屬性。例如，此介面可用於確定載入或解除安裝文件所需的時間。

效能時間線僅包含當前文件，因此效能時間線中只有一個 PerformanceNavigationTiming 物件。它繼承了 PerformanceResourceTiming 和 PerformanceEntry 的所有屬性和方法。

下圖顯示了 PerformanceNavigationTiming 中定義的所有時間戳屬性。

Timestamp diagram listing timestamps in the order in which they are recorded for the fetching of a document

例項屬性

此介面透過以下方式限定和約束 PerformanceEntry 介面的以下屬性：

PerformanceEntry.entryType 只讀: 返回 "navigation"。
PerformanceEntry.name 只讀: 返回文件的 URL。請注意，文字片段以及任何其他片段指令都會從 URL 中刪除。
PerformanceEntry.startTime 只讀: 返回值為 0 的 DOMHighResTimeStamp。
PerformanceEntry.duration 只讀: 返回一個 時間戳，該時間戳是 PerformanceNavigationTiming.loadEventEnd 和 PerformanceEntry.startTime 屬性之間的差值。

此介面還透過以下方式限定和約束 PerformanceResourceTiming 介面的以下屬性：

PerformanceResourceTiming.initiatorType 只讀: 返回 "navigation"。

該介面還支援以下屬性：

PerformanceNavigationTiming.activationStart 只讀實驗性: 一個 DOMHighResTimeStamp，表示文件開始預渲染到啟用之間的時間。
PerformanceNavigationTiming.criticalCHRestart 只讀實驗性: 一個 DOMHighResTimeStamp，表示由於 Critical-CH HTTP 響應頭不匹配而導致連線重啟的時間。
PerformanceNavigationTiming.domComplete 只讀: 一個 DOMHighResTimeStamp，表示在使用者代理將文件的 readyState 設定為 "complete" 之前的時間。
PerformanceNavigationTiming.domContentLoadedEventEnd 只讀: 一個 DOMHighResTimeStamp，表示在當前文件的 DOMContentLoaded 事件處理程式完成之後的時間。
PerformanceNavigationTiming.domContentLoadedEventStart 只讀: 一個 DOMHighResTimeStamp，表示在當前文件的 DOMContentLoaded 事件處理程式開始之前的時間。
PerformanceNavigationTiming.domInteractive 只讀: 一個 DOMHighResTimeStamp，表示在使用者代理將文件的 readyState 設定為 "interactive" 之前的時間。
PerformanceNavigationTiming.loadEventEnd 只讀: 一個 DOMHighResTimeStamp，表示在當前文件的 load 事件處理程式完成之後的時間。
PerformanceNavigationTiming.loadEventStart 只讀: 一個 DOMHighResTimeStamp，表示在當前文件的 load 事件處理程式開始之前的時間。
PerformanceNavigationTiming.notRestoredReasons 只讀實驗性: 一個 NotRestoredReasons 物件，提供關於當前文件因何種原因被阻止使用後退/前進快取（bfcache）進行導航的報告資料。
PerformanceNavigationTiming.redirectCount 只讀: 一個數字，表示當前瀏覽上下文中自上次非重定向導航以來發生的重定向次數。
PerformanceNavigationTiming.type 只讀: 一個字串，表示導航型別。可以是 "navigate"、"reload" 或 "back_forward"。
PerformanceNavigationTiming.unloadEventEnd 只讀: 一個 DOMHighResTimeStamp，表示在當前文件的 unload 事件處理程式完成之後的時間。
PerformanceNavigationTiming.unloadEventStart 只讀: 一個 DOMHighResTimeStamp，表示在當前文件的 unload 事件處理程式開始之前的時間。

例項方法

PerformanceNavigationTiming.toJSON(): 返回 PerformanceNavigationTiming 物件的 JSON 表示。

規範

規範
導航計時 Level 2 # sec-PerformanceNavigationTiming

瀏覽器相容性

另見

幫助改進 MDN

瞭解如何貢獻

此頁面最後修改於 2025 年 9 月 27 日，作者為 MDN 貢獻者。

在 GitHub 上檢視此頁面 • 報告此內容的頁面的問題