Performance API
The NotRestoredReasons interface of the Performance API provides report data containing reasons why the current document was blocked from using the back/forward cache (bfcache) on navigation.
These objects are accessed via the PerformanceNavigationTiming.notRestoredReasons property.
Instance properties
- NotRestoredReasons.children
- : An array of
NotRestoredReasonsobjects, one for each child iframe embedded in the current document, which may contain reasons why the top-level frame was blocked relating to the child frames. Each object has the same structure as the parent object — this way, any number of levels of embedded<iframe>s can be represented inside the object recursively. If the frame has no children, the array will be empty; if the document is in a cross-origin<iframe>,childrenwill returnnull.
- : An array of
- NotRestoredReasons.id
- : A string representing the
idattribute value of the<iframe>the document is contained in (for example<iframe id="foo" src="...">). If the document is not in an<iframe>or the<iframe>has noidset,idwill returnnull.
- : A string representing the
- NotRestoredReasons.name
- : A string representing the
nameattribute value of the<iframe>the document is contained in (for example<iframe name="bar" src="...">). If the document is not in an<iframe>or the<iframe>has nonameset,namewill returnnull.
- : A string representing the
- NotRestoredReasons.reasons
- : An array of NotRestoredReasonDetails objects, each representing a reason why the navigated page was blocked from using the bfcache. If the document is in a cross-origin
<iframe>,reasonswill returnnull, but the parent document may show areasonof"masked"if any<iframe>s blocked bfcache usage for the top-level frame.
- : An array of NotRestoredReasonDetails objects, each representing a reason why the navigated page was blocked from using the bfcache. If the document is in a cross-origin
- NotRestoredReasons.src
- : A string representing the path to the source of the
<iframe>the document is contained in (for example<iframe src="exampleframe.html">). If the document is not in an<iframe>,srcwill returnnull.
- : A string representing the path to the source of the
- NotRestoredReasons.url
- : A string representing the URL of the navigated page or
<iframe>. If the document is in a cross-origin<iframe>,urlwill returnnull.
- : A string representing the URL of the navigated page or
Instance methods
- NotRestoredReasons.toJSON
- : Returns a JSON-serializable plain object representing the
NotRestoredReasonsobject. Automatically called by JSON.stringify().
- : Returns a JSON-serializable plain object representing the
Examples
See Monitoring bfcache blocking reasons for examples.
Specifications
Browser compatibility
See also
- Monitoring bfcache blocking reasons
- PerformanceNavigationTiming.notRestoredReasons
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
