localStorage只能存储字符串,存对象或数组需用jsON.stringify()序列化,取时用json.parse()解析,并加try…catch防错;removeItem删单个键,clear清空同源所有数据;getItem不存在时返回NULL,需判空再解析。

localStorage 只能存字符串,所有值都会被自动转成字符串;想存对象或数组,必须手动 JSON.stringify() 和 JSON.parse()。
localStorage.setItem() 怎么用才不会丢数据
直接传非字符串值(比如对象、数字、布尔)看似能执行,但实际存进去的是调用 .toString() 后的结果:
localStorage.setItem('count', 42); console.log(localStorage.getItem('count')); // "42"(字符串) localStorage.setItem('user', { name: 'Alice' }); console.log(localStorage.getItem('user')); // "[object Object]"(完全不可用)
正确做法是显式序列化:
- 存对象:
localStorage.setItem('user', JSON.stringify({ name: 'Alice', age: 30 })) - 取的时候必须配套解析:
JSON.parse(localStorage.getItem('user')) - 操作前建议加
try...catch,因为JSON.parse()遇到损坏或空值会抛错
localStorage.removeItem() 和 clear() 的区别在哪
removeItem(key) 删除单个键,clear() 清空整个域下的所有 localStorage 数据——这个“整个域”指同源(协议 + 域名 + 端口)下所有页面共享的存储空间。
立即学习“Java免费学习笔记(深入)”;
- 误用
clear()可能导致其他功能模块(如用户登录态、主题偏好)一并丢失 - 没有“批量删除多个 key”的原生方法,要删几个就得调几次
removeItem() - 注意:它不会触发
storage事件给当前页面(只通知同域其他打开的页面)
为什么有时 getItems 返回 null 或 undefined
localStorage.getItem(key) 在 key 不存在或为空时统一返回 null,不是 undefined。常见误判场景:
- 把
null当作false直接做逻辑判断,结果跳过初始化逻辑 - 没处理
JSON.parse(null)→ 报错Unexpected Token n in JSON at position 0 - 跨域 iframe 或私密模式下,部分浏览器会直接禁用 localStorage,调用
setItem抛SecurityError
稳妥写法:
const data = localStorage.getItem('config'); const config = data ? JSON.parse(data) : { theme: 'light' };
真正麻烦的是它不支持过期时间、不能监听变化(除非靠 storage 事件且仅限其他窗口)、容量上限约 5–10MB 且因浏览器而异——这些限制一旦在复杂状态管理中被忽略,后期很难排查。