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

瀏覽器相容性

另見