StorageManager.estimate() 方法异步估算当前 origin 的存储使用量（usage）和可用配额（quota），返回 Promise，需安全上下文，结果为启发式估算而非精确值，适用于容量预警与缓存优化。
现代浏览器提供了 StorageManager.estimate() 方法，可用于异步获取当前 origin 的存储使用量和可用容量估算值。它不返回精确字节数，而是提供基于底层存储系统的合理估算，适用于判断是否接近配额上限、优化缓存策略或提示用户清理空间。
调用 estimate() 获取使用与可用容量
该方法返回一个 Promise，解析为包含 usage（已用字节数）和 quota（估算的总可用字节数）的对象：
- usage：当前 origin 所有持久化存储（如 Cache API、IndexedDB、localStorage 等）占用的粗略大小；
- quota：浏览器为该站点分配的大致最大容量，受设备总空间、系统策略、隐私模式等影响，不是固定值；
- 调用需在安全上下文（HTTPS 或 localhost）中进行，且可能被跨域 iframe 阻止。
示例代码：
<script>if ('storage' in navigator && 'estimate' in navigator.storage) {
navigator.storage.estimate().then(estimate => {
console.log('已用:', estimate.usage, '字节');
console.log('可用上限:', estimate.quota, '字节');
console.log('剩余估算:', estimate.quota - estimate.usage, '字节');
});
}
</script>
注意估算的局限性与实际偏差
该机制本质是启发式估算，并非磁盘级精确读取：
- 不同浏览器返回的
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”），应统一用“充足/紧张/不足”等状态描述。
