Storage 估算机制如何检测本地剩余空间

现代浏览器通过 `navigator.storage.estimate()` 提供了一种轻量、异步的本地存储空间估算机制，可在安全上下文中快速获取当前站点的粗略已用空间（usage）和可用配额（quota），虽非精确字节级测量，却极为实用——它能帮你提前预警容量瓶颈、优化缓存策略、避免大文件上传失败，甚至引导用户清理空间；配合 `persist()` 请求持久化权限还可提升配额稳定性与可靠性，是构建健壮离线应用和响应式存储管理不可或缺的“健康检查”工具。

现代浏览器提供了 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() 可检查当前是否已获持久授权。

例如：

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

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

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

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~