浏览器 localStorage 的使用边界:容量、序列化失败与跨标签同步
localStorage 不是数据库
localStorage 上手极快:setItem、getItem 两行代码就能存东西。但为它太顺手,很多项目它当成了数据库用,直到线上题才发现它有一圈清晰的边界。本把这条边界讲清楚:容量限制、序列化陷阱和跨标签同步,三件每一个能咬人。
本文所有示例都可在览器控制台直接运行;文中行为为标准规范的描述与常见浏览器实现,具体值以你实测准。
边界一:容量约 5MB,而且是字符串
localStorage 按来源(协议 + 域 + 端口)共享约 5MB 的配额,且所有值都以 UTF-16 字符串存储。两个直接推论
- 存 JSON 时实际用是"字符串长度"而不是对象大小, ASCII 字符(如中文)每字符占 2 个代码单元,配额耗比肉眼估快一倍。
-
-
超配额时 setItem 不返错值,而是直接抛出 QuotaExceededError。在写入大对象前应该用 try-catch 包住,而不是假设成功。
-
try { localStorage.setItem(cache, bigString) } catch (e) { // 配额满或隐私模禁用,降级方:内存缓存或 IndexedDB }边界二:只存字符串,读出来要自己判类型
localStorage.getItem 永远返回字串或 null。存进去的数字、对象、undefined 都会被静默转成字符串:
localStorage.setItem(count, 0) localStorage.getItem(count) // "0",是字符串 localStorage.setItem(flag, false) localStorage.getItem(flag) // "false",真!if (localStorage.getItem(flag)) 永远真对象需要 JSON.stringify / JSON.parse 配对使用。陷阱在于 parse 的输入可:历史遗的手写数据、被插件改过的数据都可能让 parse 抛异常,读取入口同样要 try-catch,并在失败时除该键返回默认值。
边界三:跨标签同步靠 storage 事件
同一点的多个标签页各自持有内存副,写入不自动刷新其他标签的读结果。同步机制是 storage 事件,但它有两个易的细节:
- 事件只"其"标签页触发,执行写入的那个标签页自己收不到。
-
-
事件载荷里 newValue 是字符串;被删的键 newValue null。
-
window.addEventListener(storage, (e) => { if (e.key === theme) applyTheme(e.newValue) })写完即读自己页面的 localStorage 是一致的(读的是新值),但赖 storage 事件做同页刷新是无效的——那是另一个标签页事。
边界四:不该存的别存
- 敏感信(token 之外的任凭据):localStorage 对页面内所 JS 可见,任何一个 XSS 都能读。
- (本文为个人学习笔记AI 辅助整理已人工核对 API ;具配额与实现细节各浏略有差异以测测为准)
-
-
- 点赞
- 收藏
- 关注作者
评论(0)