localStorage单域名容量约5MB(Safari无痕模式或更低),按源隔离,超限抛QuotaExceededError;仅支持字符串,存对象需JSON序列化;应try/catch写入并降级处理;大数据量推荐IndexedDB。

localStorage 在 JavaScript 中用于在浏览器中持久化存储字符串数据,但有明确的容量限制和使用边界。
localStorage 的典型容量限制
大多数现代浏览器将 localStorage 的单域名存储上限设为 5MB 左右(例如 Chrome、Firefox、Edge),部分浏览器(如 Safari 在无痕模式下)可能低至 2.5MB 或直接禁用。这个限制是**按源(origin)计算**的,即协议 + 域名 + 端口相同才共享同一份 localStorage。
- 超出限制时,调用
setItem()会抛出QuotaExceededError异常 - 不是所有浏览器都严格按字节计数——有些按字符数或内部编码长度估算,实际可用空间可能略低于标称值
- localStorage 只支持字符串,存对象需先
JSON.stringify(),读取时再JSON.parse()
如何安全地写入并应对容量不足
不能假设 setItem 一定成功,尤其在长期运行或高频写入的场景中,应主动捕获错误并降级处理:
- 用 try/catch 包裹
localStorage.setItem(key, value) - 捕获到
QuotaExceededError后,可清空过期项、压缩数据(如移除冗余字段)、或提示用户清理缓存 - 简单检测剩余空间的方法:尝试存一个较大测试字符串,根据是否报错粗略判断是否临近满载(不精确但实用)
替代方案与适用建议
当数据量大、结构复杂或需要二进制支持时,localStorage 不是最佳选择:
完全公开源代码,并无任何许可限制 特别基于大型电子商务网站的系统开发 Microsoft SQL Server 2000后台数据库,充分应用了存储过程的巨大功效 基于类模块的扩展数据访问能力支持任何类型的大型数据库 加密用户登录信息(cookie) 易于安装的系统和应用功能 100%的asp.net的代码,没有COM,java或者其他的格式 完全基于MS建议的系统安全设计 最佳的应用程序,数据库
立即学习“Java免费学习笔记(深入)”;
- IndexedDB:支持数十 MB 甚至 GB 级存储,可存对象、文件、二进制,适合离线应用、缓存大量资源
- sessionStorage:容量限制与 localStorage 相近,但仅限当前标签页生命周期,适合临时敏感数据
- Cookie:仅适合极小量(≤4KB)、需随请求自动发送的数据,不推荐用于一般存储
- 服务端同步 + 本地缓存策略:关键数据落库,localStorage 仅作快速读取副本,并定期校验一致性
基本上就这些。localStorage 简单好用,但别把它当数据库用——清楚它的边界,才能避免运行时意外崩溃。









