web storage 存储限制是动态配额,由浏览器内核、操作系统、隐私模式和磁盘空间共同决定;chrome(blink)约6.5mb,firefox(gecko)默认10mb,ios safari低至2.5mb且会主动回收。

Web Storage 的存储限制不是固定数字,而是由浏览器内核、操作系统、隐私模式和可用磁盘空间共同决定的动态配额。所谓“5MB”只是早期规范建议值,现代实际可用空间差异显著——Chrome 桌面常给 6–10 MB,Firefox 默认 10 MB 可调,iOS Safari 却可能低至 2.5 MB 且会主动回收。
按内核类型看真实配额表现
同一浏览器名下,内核才是容量行为的真正决定者:
-
Blink(Chrome/Edge/新版Opera):默认约 6.5 MB,但按源动态分配;写入超限时明确抛
QuotaExceededError,便于捕获处理 -
Gecko(Firefox):标准 10 MB,部分版本允许轻微超限(如 5.1 MB),启用
dom.storage.next_gen标志后更稳定 - WebKit(Safari/macOS/iOS):macOS 上可达 5 MB,但 iOS 私密模式直接禁用 localStorage,不报错也不写入;低内存时还会动态压缩已存数据
容量计算方式容易误判
浏览器对容量的计量单位是 UTF-16 编码字节长度,不是字符数,也不是 JSON 字符串长度:
- 一个中文字符占 2 字节(如
"中".length === 1,但底层占 2 字节) -
JSON.stringify(obj)产生的引号、逗号、空格、转义符全部计入 - 用
new TextEncoder().encode(str).length才能获得接近底层存储的真实 UTF-8 字节数
移动端与 WebView 更需实测
微信内置浏览器、QQ 浏览器、Android 系统 WebView 等环境往往比桌面保守:
- 旧版 Android WebView(如 Android 7)可能仅分配 2 MB,且异常不标准(返回
undefined或静默截断) - iOS 微信使用 WKWebView,继承 Safari 行为,私密模式下 localStorage 不可用
- 建议上线前在目标环境中运行探针脚本:
localStorage.setItem('probe', 'x'.repeat(1e6)),逐级试探并验证读取完整性
超限时的典型错误与应对逻辑
错误不会提前预警,只在 setItem() 调用瞬间触发,表现各异:
- 主流浏览器:抛
DOMException,e.name === 'QuotaExceededError' - iOS Safari 隐私模式:抛
SecurityError(因权限被拒) - 部分旧环境:无异常,但
getItem()返回null或原始值未更新 - 正确做法是每次写入都包裹
try/catch,失败后启动降级策略(如改用 IndexedDB 或服务端暂存)











