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

瀏覽器相容性

另見