配额不足时无法提前读取剩余空间,唯一可靠方式是每次写入都try-catch捕获QuotaExceededError等DOMException并分级清理:需封装多浏览器错误判定函数,优先备份核心键、按前缀/时间清理非关键数据,再降级至sessionStorage或内存,并轻量提示用户。

配额不足时无法提前读取“剩余空间”,唯一可靠的方式是捕获写入失败抛出的异常,再触发分级清理。重点不在预测,而在快速响应和安全回收。
必须每次写入都 try-catch
localStorage.setItem()、indexedDB.open()、objectStore.add() 等操作一旦超限,会同步抛出 DOMException,不捕获就会中断逻辑甚至白屏:
- 对 localStorage:包裹每一处 setItem,用统一函数判断是否为配额错误
- 对 IndexedDB:在 openRequest.onerror 和 transaction.onerror 中检查 error.name === 'QuotaExceededError'
- 不要只在初始化时检查一次——配额可能在用户操作中途耗尽
准确识别不同浏览器的配额错误
各浏览器报错形式不一致,需兼容多种标识:
- Chrome / Edge / Firefox:err.name === 'QuotaExceededError'
- 旧版 Safari:err.name === 'NS_ERROR_DOM_QUOTA_REACHED' 或 err.code === 1014
- Firefox 也可能返回 err.code === 22(DOMException.QUOTA_EXCEEDED_ERR)
- 建议封装判定函数,避免重复判断逻辑
清理要分优先级,不能直接 clear()
盲目调用 localStorage.clear() 或 indexedDB.deleteDatabase() 会丢失登录态、用户偏好等关键数据:
立即学习“前端免费学习笔记(深入)”;
- 先备份核心键:如 auth_token、theme、user_id 等,存入内存或 sessionStorage
- 按前缀清理:如删除所有以 draft_、temp_、cache_ 开头的 key
- 按时间清理:遍历 key,解析其存储的时间戳,删掉 7 天前的过期项
- IndexedDB 可按 objectStore 分片处理,例如只清空 logs 表,保留 users 和 settings
清理后要降级并提示用户
清完不等于万事大吉,得让后续写入继续可用:
- 非关键数据(如表单草稿、滚动位置)可降级到内存 Map 或 sessionStorage
- 核心数据若 localStorage 不可用,尝试写入 sessionStorage;仍失败则暂存内存,页面卸载前尝试回写
- 向用户轻量提示:“本地缓存已满,最近的草稿未持久化”——不打断操作,但建立预期
- 避免静默失败,尤其在移动端,用户感知弱,误以为功能失灵



















