NotRestoredReasonDetails: reason 屬性
NotRestoredReasonDetails 介面的只讀屬性 **reason** 返回一個字串,描述了頁面被阻止使用後退/前進快取(bfcache)的原因。
值
字串。
阻止可能發生的原因有很多,瀏覽器可以根據其執行方式選擇實現自己特定的阻止原因。開發者應避免依賴特定措辭的原因,並準備好處理新增或刪除的原因。
規範中列出的初始值如下:
"fetch"-
在解除安裝過程中,由當前文件發起的 fetch 請求(例如,透過
fetch())在進行中被取消。因此,頁面處於不穩定狀態,無法儲存在 bfcache 中。 "lock"-
在解除安裝過程中,持有的鎖和鎖請求被終止,因此頁面處於不穩定狀態,無法儲存在 bfcache 中。
"masked"-
出於隱私目的,確切原因被隱藏。此值可能表示以下情況之一:
- 當前文件包含的子級位於一個跨源
<iframe>中,並且它們阻止了 bfcache 的儲存。 - 由於使用者代理特有的原因,當前文件無法儲存在 bfcache 中。
- 當前文件包含的子級位於一個跨源
-
建立當前文件的原始導航發生錯誤,並且阻止了生成的錯誤文件儲存在 bfcache 中。
"parser-aborted"-
當前文件從未完成其初始 HTML 解析,並且阻止了未完成的文件儲存在 bfcache 中。
"websocket"-
在解除安裝過程中,已開啟的 WebSocket 連線被關閉,因此頁面處於不穩定狀態,無法儲存在 bfcache 中。
某些瀏覽器可能還會使用其他阻止原因,例如:
"unload-listener"-
頁面註冊了
unload事件監聽器,這會阻止 bfcache 的使用。這是一個有用的警告,因為unload事件已被棄用。有關更多資訊,請參閱 用法說明。 "response-cache-control-no-store"-
頁面將
no-store用作Cache-Control標頭值。 -
該頁面是由另一個仍對此頁面有引用的頁面開啟的,例如使用了“複製標籤頁”功能。
示例
有關示例,請參閱 Monitoring bfcache blocking reasons。
規範
| 規範 |
|---|
| HTML # dom-not-restored-reason-details-reason |
瀏覽器相容性
載入中…