Performance API
PerformanceNavigationTiming 提供了用于存储和检索有关浏览器文档事件的指标的方法和属性。例如,此接口可用于确定加载或卸载文档需要多少时间。
性能时间线中只包含当前文档,因此性能时间线中只有一个 PerformanceNavigationTiming 对象。它继承了 PerformanceResourceTiming 和 PerformanceEntry 的所有属性和方法。
下图显示了 PerformanceNavigationTiming 中定义的所有时间戳属性。
按获取文档时记录的时间戳顺序排列的时间戳图
实例属性
该接口扩展了 PerformanceEntry 属性,修订和约束以下性能条目:
- PerformanceEntry.entryType
- : 返回
"navigation"。
- : 返回
- PerformanceEntry.name
- : 返回文档的 URL。
- PerformanceEntry.startTime
- : 返回值为 0 的 DOMHighResTimeStamp。
- PerformanceEntry.duration
- : 返回 DOMHighResTimeStamp 值,即 PerformanceNavigationTiming.loadEventEnd 和 PerformanceEntry.startTime 属性之间的差值。
该接口还扩展 PerformanceResourceTiming 属性,修订和约束以下性能条目:
- PerformanceResourceTiming.initiatorType
- : 返回
"navigation"。
- : 返回
该接口还支持以下属性:
- PerformanceNavigationTiming.domComplete
- : 一个 DOMHighResTimeStamp 表示用户代理将文档的
readyState设置为"complete"的时间。
- : 一个 DOMHighResTimeStamp 表示用户代理将文档的
- PerformanceNavigationTiming.domContentLoadedEventEnd
- : 一个 DOMHighResTimeStamp 表示当前文档的
DOMContentLoaded事件处理器结束的时间。
- : 一个 DOMHighResTimeStamp 表示当前文档的
- PerformanceNavigationTiming.domContentLoadedEventStart
- : 一个 DOMHighResTimeStamp 表示当前文档的
DOMContentLoaded事件处理器开始的时间。
- : 一个 DOMHighResTimeStamp 表示当前文档的
- PerformanceNavigationTiming.domInteractive
- : 一个 DOMHighResTimeStamp 表示用户代理将文档的
readyState设置为"interactive"的时间。
- : 一个 DOMHighResTimeStamp 表示用户代理将文档的
- PerformanceNavigationTiming.loadEventEnd
- : 一个 DOMHighResTimeStamp 表示当前文档的
load事件处理器结束的时间。
- : 一个 DOMHighResTimeStamp 表示当前文档的
- PerformanceNavigationTiming.loadEventStart
- : 一个 DOMHighResTimeStamp 表示当前文档的
load事件处理器开始的时间。
- : 一个 DOMHighResTimeStamp 表示当前文档的
- PerformanceNavigationTiming.redirectCount
- : 表示在当前浏览上下文中上次非重定向导航以来的重定向次数的数字。
- PerformanceNavigationTiming.type
- : 一个表示导航类型的字符串,取值为:
"navigate"、"reload"、"back_forward"或"prerender"。
- : 一个表示导航类型的字符串,取值为:
- PerformanceNavigationTiming.unloadEventEnd
- : 一个 DOMHighResTimeStamp 表示当前文档的
unload事件处理程序结束的时间。
- : 一个 DOMHighResTimeStamp 表示当前文档的
- PerformanceNavigationTiming.unloadEventStart
- : 一个 DOMHighResTimeStamp 表示当前文档的
unload事件处理程序开始的时间。
- : 一个 DOMHighResTimeStamp 表示当前文档的
实例方法
- PerformanceNavigationTiming.toJSON()
- : 返回一个表示
PerformanceNavigationTiming对象的 JSON。
- : 返回一个表示
规范
浏览器兼容性
参见
- Performance.navigation
- PerformanceNavigation
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
