localstorage.setitem() 存不进数据主因有三:值未转字符串、超存储限额、私密模式禁用;对象须json.stringify(),超限需try...catch,私密模式应检测可用性。

localStorage.setItem() 存不进去?检查这三件事
存不进 localStorage,八成不是 API 有问题,而是值没过“关”。它只接受字符串,传对象、数组、null 或 undefined 都会静默转成 "null" 或 "undefined",看着像存了,取出来根本不是你要的。
- 对象必须先
JSON.stringify(),取的时候再JSON.parse()—— 不做这步,存进去是"[object Object]" -
localStorage.setItem("user", null)实际存的是字符串"null",不是删除键;真要删用localStorage.removeItem("user") - 超过浏览器限额(通常 5–10MB)会抛
QuotaExceededError,不是报错就是静默失败,建议存前加try...catch
sessionStorage 和 localStorage 到底该选哪个
区别不在“临时”和“永久”,而在生命周期绑定对象:前者绑标签页(tab),后者绑域名(origin)。关掉 tab 就清空 sessionStorage,哪怕刷新、前进后退都还在;而 localStorage 要手动清或用户主动删数据才消失。
- 登录态 token 用
localStorage?风险高——XSS 攻击可直接读取。更安全的做法是存在内存变量 + httpOnly Cookie - 表单草稿、筛选条件、主题偏好这类用户可接受重置的数据,用
sessionStorage更合适,避免跨 tab 干扰 - 同域名下两个子应用(如
app.example.com和admin.example.com)无法共享localStorage,它们算不同 origin
监听 storage 变化为什么没反应
storage 事件只在「其他同源窗口」触发变更时才派发,当前页面自己调 setItem() 不会触发自己的监听器。这是设计使然,不是 bug。
- 监听写法必须是
window.addEventListener("storage", handler),不能用onstorage = handler - 事件对象
event.key是被改的键名,event.newValue是新值(可能为null),event.oldValue是旧值 —— 但注意:如果值没变,oldValue === newValue - 私密模式下 Safari 和部分 iOS 版本会禁用
localStorage,storage事件自然也不会触发,建议先检测可用性:try { localStorage.getItem("") } catch(e) { /* fallback */ }
localStorage 性能瓶颈在哪
读写本身很快,慢在序列化和锁机制。每次 setItem() 都会同步阻塞当前线程,大对象(比如 >1MB 的 JSON)会导致 UI 卡顿;更隐蔽的问题是,同一域名下所有 tab 共享一个存储锁,高频写入时容易排队等待。
立即学习“前端免费学习笔记(深入)”;
- 避免在循环里反复
setItem("counter", i++),应合并成一次操作,或改用内存缓存 + 定时批量落盘 - 不要把
localStorage当数据库用——没有索引、不支持查询、无法事务回滚。只是键值对,仅适合简单状态快照 - 调试时别依赖浏览器 DevTools 的 “Application → Storage” 面板实时刷新,有时显示滞后;最准的方式是直接执行
localStorage.getItem("key")
真正麻烦的不是怎么写,而是忘了它没有过期机制、不会自动清理、也不加密——存什么、谁来删、什么时候删,全得你心里有数。











