navigator.storage.estimate() 必须在安全上下文中异步调用，返回 usage 和 quota 的估算值，quota 动态变化且非精确，需结合 persist() 提升稳定性并避免依赖其绝对数值。
直接调用 navigator.storage.estimate() 获取 usage 和 quota
必须在安全上下文（https:// 或 localhost）中执行，否则 navigator.storage 为 undefined，调用会抛出 TypeError。该方法返回 Promise，不能同步读取：
if ('storage' in navigator && 'estimate' in navigator.storage) {
navigator.storage.estimate().then(({ usage, quota }) => {
console.log('已用:', usage, '字节');
console.log('估算配额:', quota, '字节');
console.log('剩余估算:', quota - usage, '字节');
}).catch(err => {
console.warn('estimate 失败:', err.name); // 常见 NetworkError / SecurityError / TypeError
});
}- 不要在页面加载初期（如
DOMContentLoaded触发前）就调用——等用户有交互（如点击按钮）后再执行，Chrome 在无用户手势时可能返回quota: 0 -
usage是当前 origin 所有持久化存储（IndexedDB、Cache API、localStorage 等）的压缩后总占用，不是原始字节数 -
quota是软上限，非磁盘级精确值：Chrome 桌面可达 GB 级，Android WebView 可能仅几百 MB，Safari 17.5 仍返回{usage: 0, quota: 0}
为什么 quota 经常是 0 或远高于实际可用空间
这不是 bug，而是设计使然：quota 是浏览器根据空闲磁盘、内存、用户活跃度、是否安装为 PWA 等动态估算的结果，不是固定配额。
- Chrome 中未触发“高信任上下文”（如无用户手势、无 Storage Access API 授权）时，
quota常为 0 - Safari 长期不支持该 API，即使存在也返回
0，不能用于判断容量压力 - 隐身/无痕模式下，Chrome 默认配额约 128–1500 MB（非固定），Firefox 更保守，
usage可能为 0 - 不要用
quota - usage做精确写入判断；更适合看比值，例如usage / quota > 0.85表示高风险
结合 navigator.storage.persist() 提升配额稳定性
对 PWA 或需长期缓存的 Web 应用，可主动请求持久化权限，部分浏览器会在授权后返回更高、更稳定的 quota 值。
navigator.storage.persist().then(granted => {
if (granted) {
console.log('已获持久化授权');
} else {
console.log('用户拒绝或未弹出提示');
}
return navigator.storage.estimate();
}).then(({ usage, quota }) => {
console.log(`持久化后配额: ${quota} 字节`);
});-
navigator.storage.persist()是用户感知操作，可能触发浏览器权限提示，不可静默调用 - 调用后需再次
estimate()，首次调用仍可能返回旧配额（需等待浏览器更新内部状态） - 用
navigator.storage.persisted()可检查当前是否已授权，避免重复请求 - 注意：现代浏览器普遍限制自动授予，尤其在低活跃度站点上，成功率不高
无法区分具体存储类型的占用，只能做 origin 级总览
navigator.storage.estimate() 不提供 localStorage、IndexedDB、Cache API 各自的用量拆分，它反映的是整个 origin 的统一配额池。
立即学习“前端免费学习笔记（深入）”；
- IndexedDB 写入失败时，不能靠它定位是哪类数据占满——必须配合监听
QuotaExceededError异常 - localStorage 超限（
QuotaExceededError）不会单独抬高usage，但会算进总用量里 - Cache API 缓存大量资源后，
quota可能被快速消耗，但你无法从 estimate 结果反推 Cache 占了多少 - 真正需要精细化监控时，得自己维护写入计数器 + Blob.size 估算 + 定期清理策略，而不是依赖 estimate 返回值
实际使用中最容易被忽略的一点：它不报错也不阻塞，但返回值随时可能失效。比如用户刚清过缓存，或系统磁盘空间突变，quota 下一秒就可能翻倍或归零。别把它当数据库字段缓存，每次需要判断空间压力时，都应重新 fetch 并容忍失败。
