PerformanceNavigationTiming

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since October 2021.

PerformanceNavigationTiming 提供了用于存储和检索有关浏览器文档事件的指标的方法和属性。例如，此接口可用于确定加载或卸载文档需要多少时间。

性能时间线中只包含当前文档，因此性能时间线中只有一个 PerformanceNavigationTiming 对象。它继承了 PerformanceResourceTiming 和 PerformanceEntry 的所有属性和方法。

PerformanceEntry PerformanceResourceTiming PerformanceNavigationTiming

下图显示了 PerformanceNavigationTiming 中定义的所有时间戳属性。

按获取文档记录的顺序列出时间戳的时间戳图

实例属性

该接口扩展了 PerformanceEntry 属性，修订和约束以下性能条目：

PerformanceEntry.entryType 只读

返回 "navigation"。

PerformanceEntry.name 只读

返回文档的 URL。

PerformanceEntry.startTime 只读

返回值为 0 的 DOMHighResTimeStamp。

PerformanceEntry.duration 只读

返回 timestamp 值，即 PerformanceNavigationTiming.loadEventEnd 和 PerformanceEntry.startTime 属性之间的差值。

该接口还扩展 PerformanceResourceTiming 属性，修订和约束以下性能条目：

PerformanceResourceTiming.initiatorType只读

返回 "navigation"。

该接口还支持以下属性：

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.redirectCount 只读

表示在当前浏览上下文中上次非重定向导航以来的重定向次数的数字。

PerformanceNavigationTiming.type 只读

一个表示导航类型的字符串，取值为："navigate"、"reload"、"back_forward" 或 "prerender"。

PerformanceNavigationTiming.unloadEventEnd 只读

一个 DOMHighResTimeStamp 表示当前文档的 unload 事件处理程序结束的时间。

PerformanceNavigationTiming.unloadEventStart 只读

一个 DOMHighResTimeStamp 表示当前文档的 unload 事件处理程序开始的时间。

实例方法

PerformanceNavigationTiming.toJSON()

返回一个表示 PerformanceNavigationTiming 对象的 JSON。

规范

Specification
Navigation Timing Level 2
# sec-PerformanceNavigationTiming

浏览器兼容性

BCD tables only load in the browser

参见