如何用 storage 估算机制检测本地剩余可用存储容量大小-js教程-PHP中文网

storagemanager.estimate() 方法异步估算当前 origin 的存储使用量（usage）和可用配额（quota），返回 promise，需安全上下文，结果为启发式估算而非精确值，适用于容量预警与缓存优化。

如何用 storage 估算机制检测本地剩余可用存储容量大小

现代浏览器提供了 StorageManager.estimate() 方法，可用于异步获取当前 origin 的存储使用量和可用容量估算值。它不返回精确字节数，而是提供基于底层存储系统的合理估算，适用于判断是否接近配额上限、优化缓存策略或提示用户清理空间。

调用 estimate() 获取使用与可用容量

该方法返回一个 Promise，解析为包含 usage（已用字节数）和 quota（估算的总可用字节数）的对象：

usage：当前 origin 所有持久化存储（如 Cache API、IndexedDB、localStorage 等）占用的粗略大小；
quota：浏览器为该站点分配的大致最大容量，受设备总空间、系统策略、隐私模式等影响，不是固定值；
调用需在安全上下文（HTTPS 或 localhost）中进行，且可能被跨域 iframe 阻止。

示例代码：

注意估算的局限性与实际偏差

该机制本质是启发式估算，并非磁盘级精确读取：

不同浏览器返回的 quota 差异较大（Chrome 可能返回数 GB，Firefox 可能更保守）；
隐身/无痕模式下通常返回极小 quota（如 128MB），且 usage 可能为 0；
部分 Android WebView 或旧版 Safari 尚未支持，需做特性检测；
无法区分 localStorage、IndexedDB、Cache 等具体存储类型的占用，仅提供 origin 总览。

结合持久化存储请求提升可靠性

若需更稳定的长期存储保障，可主动请求持久化权限，提高配额稳定性：

调用 navigator.storage.persist() 请求将存储设为“持久”（用户可能收到提示）；
之后再调用 estimate()，部分浏览器会返回更高、更稳定的 quota 值；
配合 navigator.storage.persisted() 可检查当前是否已获持久授权。

例如：

navigator.storage.persist().then(granted => {
if (granted) console.log('已获得持久化授权');
return navigator.storage.estimate();
}).then(estimate => { ... });

实用建议：用于容量预警而非精确计算

把 estimate() 当作轻量级健康检查工具：

当 (usage / quota) > 0.8 时，可提示用户“缓存较多，建议清理”；
上传大文件前先检查剩余空间，避免中途写入失败；
搭配 IndexedDB 的 onblocked 或 onupgradeneeded 错误，作为辅助诊断手段；
不要依赖其数值做单位换算展示（如显示“还剩 2.3GB”），应统一用“充足/紧张/不足”等状态描述。