| CARVIEW |
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.
* Some parts of this feature may have varying levels of support.
The PerformanceNavigationTiming interface provides methods and properties to store and retrieve metrics regarding the browser's document navigation events. For example, this interface can be used to determine how much time it takes to load or unload a document.
Only the current document is included in the performance timeline, so there is only one PerformanceNavigationTiming object in the performance timeline. It inherits all of the properties and methods of PerformanceResourceTiming and PerformanceEntry.
The following diagram shows all of the timestamp properties defined in PerformanceNavigationTiming.
Instance properties
This interface extends the following PerformanceEntry properties by qualifying and constraining them as follows:
PerformanceEntry.entryTypeRead only-
Returns
"navigation". PerformanceEntry.nameRead only-
Returns the document's URL. Note that text fragments, and any other fragment directives, are stripped from the URL.
PerformanceEntry.startTimeRead only-
Returns a
DOMHighResTimeStampwith a value of0. PerformanceEntry.durationRead only-
Returns a
timestampthat is the difference between thePerformanceNavigationTiming.loadEventEndandPerformanceEntry.startTimeproperties.
This interface also extends the following PerformanceResourceTiming properties by qualifying and constraining them as follows:
PerformanceResourceTiming.initiatorTypeRead only-
Returns
"navigation".
The interface also supports the following properties:
PerformanceNavigationTiming.activationStartRead only Experimental-
A
DOMHighResTimeStamprepresenting the time between when a document starts prerendering and when it is activated. PerformanceNavigationTiming.criticalCHRestartRead only Experimental-
A
DOMHighResTimeStamprepresenting the time at which the connection restart occurred due toCritical-CHHTTP response header mismatch. PerformanceNavigationTiming.domCompleteRead only-
A
DOMHighResTimeStamprepresenting the time immediately before the user agent sets the document'sreadyStateto"complete". PerformanceNavigationTiming.domContentLoadedEventEndRead only-
A
DOMHighResTimeStamprepresenting the time immediately after the current document'sDOMContentLoadedevent handler completes. PerformanceNavigationTiming.domContentLoadedEventStartRead only-
A
DOMHighResTimeStamprepresenting the time immediately before the current document'sDOMContentLoadedevent handler starts. PerformanceNavigationTiming.domInteractiveRead only-
A
DOMHighResTimeStamprepresenting the time immediately before the user agent sets the document'sreadyStateto"interactive". PerformanceNavigationTiming.loadEventEndRead only-
A
DOMHighResTimeStamprepresenting the time immediately after the current document'sloadevent handler completes. PerformanceNavigationTiming.loadEventStartRead only-
A
DOMHighResTimeStamprepresenting the time immediately before the current document'sloadevent handler starts. PerformanceNavigationTiming.notRestoredReasonsRead only Experimental-
A
NotRestoredReasonsobject providing report data on reasons why the current document was blocked from using the back/forward cache (bfcache) on navigation. PerformanceNavigationTiming.redirectCountRead only-
A number representing the number of redirects since the last non-redirect navigation in the current browsing context.
PerformanceNavigationTiming.typeRead only-
A string representing the navigation type. Either
"navigate","reload", or"back_forward". PerformanceNavigationTiming.unloadEventEndRead only-
A
DOMHighResTimeStamprepresenting the time immediately after the current document'sunloadevent handler completes. PerformanceNavigationTiming.unloadEventStartRead only-
A
DOMHighResTimeStamprepresenting the time immediately before the current document'sunloadevent handler starts.
Instance methods
PerformanceNavigationTiming.toJSON()-
Returns a JSON representation of the
PerformanceNavigationTimingobject.
Specifications
| Specification |
|---|
| Navigation Timing Level 2 # sec-PerformanceNavigationTiming |