大网数据广告活动
Web 标准与前端开发

NotRestoredReasons

· 52CE 我爱测

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.

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 NotRestoredReasons objects, 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>, children will return null.
  • NotRestoredReasons.id
    • : A string representing the id attribute 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 no id set, id will return null.
  • NotRestoredReasons.name
    • : A string representing the name attribute 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 no name set, name will return null.
  • 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>, reasons will return null, but the parent document may show a reason of "masked" if any <iframe>s blocked bfcache usage for the top-level frame.
  • 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>, src will return null.
  • NotRestoredReasons.url
    • : A string representing the URL of the navigated page or <iframe>. If the document is in a cross-origin <iframe>, url will return null.

Instance methods

  • NotRestoredReasons.toJSON
    • : Returns a JSON-serializable plain object representing the NotRestoredReasons object. Automatically called by JSON.stringify().

Examples

See Monitoring bfcache blocking reasons for examples.

Specifications

Browser compatibility

See also

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。