永久存储

永久存储空间有助于保护关键数据免遭驱逐，并降低数据丢失的几率。

Pete LePage

面对磁盘空间不足等存储压力时，浏览器通常会从最近最少使用的来源中逐出数据，包括从 Cache API 和 IndexedDB 中逐出的数据。如果应用尚未与服务器同步数据，这可能会导致数据丢失；如果移除应用正常运行所需的资源，则会降低应用的可靠性，这两种情况都会导致用户体验不佳。

幸运的是，Chrome 团队的研究表明，Chrome 很少自动清除数据。用户手动清理存储空间的情况更为常见。因此，如果用户定期访问您的网站，您的数据被逐出的可能性很小。如需防止浏览器删除您的数据，您可以请求将整个网站的存储空间标记为持久性存储空间。

注意：仅应针对以下重要数据（例如端到端加密密钥）请求将您网站的所有数据标记为永久性数据：如果未备份到云端，可能会导致大量数据丢失。浏览器不会删除永久性存储，即使存储空间不足也是如此。只有当用户选择通过网站设置将其移除时，系统才会删除该内容。

许多现代浏览器都支持永久性存储。

浏览器支持

• 55
• 79
• 57
• 15.2

来源

如需详细了解驱逐、可存储的数据量以及如何处理配额限制，请参阅适用于 Web 的存储空间。

检查您的网站存储空间是否已被标记为永久性存储

您可以使用 JavaScript 确定网站的存储空间是否已标记为永久性存储空间。调用 navigator.storage.persisted() 会返回一个 Promise，该 Promise 会解析为布尔值，表示存储空间是否已标记为持久化。

// Check if site's storage has been marked as persistent
if (navigator.storage && navigator.storage.persist) {
  const isPersisted = await navigator.storage.persisted();
  console.log(`Persisted storage granted: ${isPersisted}`);
}

何时应该请求永久性存储？

请求将存储空间标记为永久存储空间的最佳时机是保存关键用户数据时，并且该请求最好封装在用户手势中。请勿在页面加载时或在其他引导代码中请求永久存储，否则浏览器可能会提示用户授予权限。如果用户没有执行他们认为需要保存的任何操作，提示可能会令人感到困惑，并可能会拒绝请求。此外，提示不要过于频繁。如果用户决定不授予权限，不要在下一次保存时立即再次提示。

请求永久性存储空间

如需为您网站的数据请求永久性存储空间，请调用 navigator.storage.persist()。它会返回一个 promise，该 promise 会解析为布尔值，指示是否已授予永久存储权限。

// Request persistent storage for site
if (navigator.storage && navigator.storage.persist) {
  const isPersisted = await navigator.storage.persist();
  console.log(`Persisted storage granted: ${isPersisted}`);
}

注意 ：用于检查网站存储空间是否已标记为永久性存储空间的 API 名称与用于请求永久性存储空间的 API 名称非常相似。我记住这两者的区别的方法是：persisted() 是过去时，用于检查它是否已持久化。而 persist() 是现在时，表示立即请求。

如何授予权限？

永久性存储被视为权限。浏览器会根据不同的因素来决定是否授予持久性存储权限。

Chrome 和其他基于 Chromium 的浏览器

Chrome 和大多数其他基于 Chromium 的浏览器会自动处理权限请求，不会向用户显示任何提示。相反，如果某个网站被视为重要网站，系统会自动授予永久性存储权限，否则会静默拒绝。

判断网站是否重要的方法包括：

• 网站互动度有多高？
• 网站是否已安装或加入书签？
• 该网站是否已获权显示通知？

如果请求被拒绝，可以稍后再次请求，并将使用相同的启发法进行评估。

Firefox

Firefox 将权限请求委托给用户。当请求永久性存储空间时，系统会通过界面弹出式窗口询问用户是否允许网站在永久性存储空间中存储数据。

当网站请求永久性存储空间时，Firefox 显示的弹出式窗口。

什么存储空间受永久性存储的保护？

如果授予永久性存储空间权限，浏览器将不会驱逐存储在以下位置的数据：

• Cache API
• Cookie
• DOM 存储空间（本地存储空间）
• File System API（浏览器提供的沙盒文件系统）
• IndexedDB
• Service Worker
• 应用缓存（已废弃，不应使用）
• WebSQL（已弃用，不应使用）

如何关闭永久性存储

目前，没有程序化方法可以告知浏览器您不再需要永久性存储空间。

总结

Chrome 团队的研究表明，虽然 Chrome 可能会自动清除存储的数据，但这种情况很少见。为了保护可能无法存储在云端或会导致大量数据丢失的关键数据，永久性存储空间可作为一种有用的工具，确保当本地设备面临存储压力时，浏览器不会移除您的数据。请记住，仅在用户最有可能需要永久性存储空间时请求永久性存储空间。

谢谢

特别感谢 Victor Costan 和 Joe Medley 审核本文。 感谢 Chris Wilson 撰写本文的原始版本，该版本首次出现在 WebFundamentals 上。

Umberto 在 Unshot 上使用的主打图片