localStorage需手动序列化/反序列化对象,用JSON.stringify()存、JSON.parse()取并捕获SyntaxError;sessionStorage仅当前标签页有效,关闭即销毁;二者均不参与HTTP请求,localStorage同源共享且持久,sessionStorage隔离且临时。
localStorage 和 sessionStorage 都能存字符串,但生命周期、作用域和用途完全不同——别用错,否则数据会莫名其妙消失或跨标签泄露。
localStorage 只接受字符串,直接存对象会变成 [object Object];必须手动序列化和反序列化。
JSON.stringify() 转对象为字符串,再传给 localStorage.setItem()
localStorage.getItem() 拿字符串,再用 JSON.parse() 还原(注意捕获 SyntaxError)localStorage.removeItem();清空全部:用 localStorage.clear()
localStorage.setItem('user', JSON.stringify({id: 123, name: 'Alice'}));
const user = JSON.parse(localStorage.getItem('user') || '{}');
两者 API 完全一致,但行为差异直接影响功能设计:
localStorage:数据永久保存(除非手动清除),同源下所有标签页、窗口共享sessionStorage:仅当前标签页有效,关闭该标签页即销毁;即使同源,新开标签页也拿不到之前的数据比如表单草稿适合用 sessionStorage(关掉页面就丢,不污染长期存储);用户偏好设置更适合 localStorage。
常见原因不是 API 写错,而是环境或操作问题:
localStorage 可能被禁用,调用会抛 SecurityError —— 必须加 try/catch
setItem() 会静默失败或抛 QuotaExceededError
getItem() 找不到键时返回 null,不是空字符串,直接 JSON.parse(null) 会报错http vs https)、子域名(a.example.com vs b.example.com)视为不同源,无法共享可以,但只在「其他标签页」修改时触发本页的 storage 事件,当前页改自己不会触发。
window.addEventListener('storage', handler)
event.key、event.oldValue、event.newValue、event.url
这个机制适合做跨标签页状态同步(如登录态刷新),但别指望它替代状态管理库。
真正容易被忽略的是:localStorage 是阻塞式同步 API,大量读写会卡主线程;如果存的是大对象或频繁操作,得考虑防抖、分片或换用 Inde
