StorageManager: persisted() 方法

Baseline 已廣泛支援

此功能已成熟,可在多種裝置和瀏覽器版本上使用。自 2021 年 12 月以來,它已在所有瀏覽器中可用。

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

注意:此功能在 Web Workers 中可用。

StorageManager 介面的 persisted() 方法返回一個 Promise,如果你的網站的儲存桶是持久化的,則該 Promise 解析為 true

語法

js
persisted()

引數

無。

返回值

一個 Promise,解析為 Boolean

異常

TypeError

如果獲取本地儲存空間失敗,則丟擲此異常。例如,如果當前來源是不透明來源,或者使用者已停用儲存。

示例

js
if (navigator.storage && navigator.storage.persist) {
  navigator.storage.persisted().then((persistent) => {
    if (persistent) {
      console.log("Storage will not be cleared except by explicit user action");
    } else {
      console.log("Storage may be cleared by the UA under storage pressure.");
    }
  });
}

規範

規範
Storage
# dom-storagemanager-persisted

瀏覽器相容性