IndexedDB 无直接配额API,需组合使用 StorageManager.estimate() 间接监控、捕获 QuotaExceededError 错误、主动分片压缩数据及引导用户清理。

IndexedDB 没有统一、可直接读取的“剩余配额”API,浏览器不提供类似 navigator.storage.estimate() 对 IndexedDB 的独立反馈,但可通过组合策略实现有效监控与空间不足应对。
利用 StorageManager.estimate() 间接评估整体持久化存储压力
虽然该 API 不专为 IndexedDB 设计,但它反映的是当前 origin 下所有持久化存储(含 IndexedDB、Cache API、Service Worker 缓存等)的综合使用情况。当 usage 接近 quota(尤其 >80%),IndexedDB 写入失败风险显著上升。
- 调用
navigator.storage.estimate()返回 Promise,解析后检查usage / quota比值 - 注意:Safari 和部分旧版 Chrome 中该 API 可能返回
quota: 0或不支持,需加try/catch和降级逻辑 - 建议每小时或关键写入前主动检测一次,避免高频轮询影响性能
监听 IndexedDB 打开/事务失败,捕获 QuotaExceededError
这是最直接、最可靠的信号。当磁盘空间真正耗尽或超出浏览器分配限额时,indexedDB.open() 或 transaction.objectStore().add() 等操作会抛出 QuotaExceededError(DOMException code 22)。
- 在
openRequest.onerror和事务的onerror中统一判断event.target.error.name === 'QuotaExceededError' - 触发后立即停止新写入,启动清理流程(如删除过期日志、降级缓存策略、提示用户)
- 避免静默忽略——即使你认为“数据不重要”,反复失败可能使数据库进入不可用状态
主动控制数据规模:分片 + 过期 + 压缩
不依赖配额感知,而是从设计上规避空间瓶颈:
立即学习“前端免费学习笔记(深入)”;
-
按时间或用途分库:例如将日志存
log_db_v202405,每月新建,旧库只读或归档导出 -
写入前检查记录数/体积估算:对批量插入,先统计待存对象总大小(可用
new Blob([JSON.stringify(obj)]).size粗略估算),超阈值则截断或拒绝 -
启用压缩字段:对长文本、JSON 配置等,用
TextEncoder+pako(轻量 zlib 实现)压缩后再存,读取时解压,通常节省 60%+ 空间
引导用户释放空间或切换存储策略
当检测到持续配额紧张,前端可温和干预:
- 显示非阻断提示:“本地缓存接近上限,已自动清理 3 天前日志”
- 提供“清空离线数据”按钮,调用
indexedDB.deleteDatabase(dbName)并重初始化 - 对非核心数据(如预加载图片、离线文章正文),降级为内存 Map 或 sessionStorage 存储,仅保留关键结构索引在 IndexedDB
- 不推荐强制请求持久化存储(
navigator.storage.persist()),因现代浏览器普遍限制其成功率,且用户授权意愿低
不复杂但容易忽略:真正的空间问题往往不是“满了”,而是“碎片化+突发写入”导致临时失败。保持定期清理习惯比等待错误更稳妥。


















