NotRestoredReasons

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

实验性: 这是一项实验性技术
在生产中使用此技术之前,请仔细检查浏览器兼容性表格

NotRestoredReasons 接口属于 Performance API,提供报告数据,其中包含当前文档因何原因被阻止使用后退/前进缓存(bfcache)的导航信息。

这些对象可以通过 PerformanceNavigationTiming.notRestoredReasons 属性访问。

实例属性

children 只读 实验性

一个 NotRestoredReasons 对象数组,数组中的每个对象代表当前文档中的一个嵌入式 <iframe>。这些对象可能包含与子框架相关的、导致顶级框架被阻止使用 bfcache 的原因。每个对象都与父对象具有相同的结构——这样,就可以通过递归的方式在对象中表示任意层级的嵌入式 <iframe>。如果框架没有子框架,则数组将为空;如果文档位于跨域 <iframe> 中,则 children 将返回 null

id 只读 实验性

一个字符串,表示文档所在的 <iframe>id 属性值(例如 <iframe id="foo" src="...">)。如果文档不位于 <iframe> 中,或者该 <iframe> 没有设置 id,则 id 将返回 null

name 只读 实验性

一个字符串,表示文档所在的 <iframe>name 属性值(例如 <iframe name="bar" src="...">)。如果文档不位于 <iframe> 中,或者该 <iframe> 没有设置 name,则 name 将返回 null

reasons 只读 实验性

一个 NotRestoredReasonDetails 对象数组,每个对象代表导航页面被阻止使用 bfcache 的一个原因。如果文档位于跨域 <iframe> 中,则 reasons 将返回 null,但父文档可能会显示一个 reason"masked" 的原因,表示任何 <iframe> 阻止了顶级框架使用 bfcache。

src 只读 实验性

一个字符串,表示文档所在的 <iframe> 的源路径(例如 <iframe src="exampleframe.html">)。如果文档不位于 <iframe> 中,则 src 将返回 null

url 只读 实验性

一个字符串,表示导航页面或 <iframe> 的 URL。如果文档位于跨域 <iframe> 中,则 url 将返回 null

实例方法

toJSON() 实验性

一个 序列化器;返回 NotRestoredReasons 对象的 JSON 表示。

示例

有关示例,请参阅 Monitoring bfcache blocking reasons

规范

规范
HTML
# notrestoredreasons

浏览器兼容性

另见