StorageManager: persist() 方法

安全上下文:此功能仅在安全上下文(HTTPS)中可用,在一些或所有支持的浏览器中可用。

persist()StorageManager接口的方法,用于请求使用持久性存储的权限,并返回一个Promise,如果权限授予且存储模式为持久性,则该Promise解析为true,否则解析为false。浏览器可能会或可能不会接受该请求,具体取决于特定于浏览器的规则。(有关更多详细信息,请参阅存储配额和清除标准指南。)

注意:此方法在Web Workers中不可用,尽管StorageManager接口可用。

语法

js
persist()

参数

无。

返回值

一个解析为BooleanPromise

异常

TypeError

如果获取本地存储货架失败,则抛出。例如,如果当前来源是不透明来源或用户已禁用存储。

示例

js
if (navigator.storage && navigator.storage.persist) {
  navigator.storage.persist().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 Standard
# ref-for-dom-storagemanager-persist

浏览器兼容性

BCD 表仅在浏览器中加载