LocalStorage 是浏览器提供的同源字符串持久化存储,容量约5–10MB;需用 setItem/getItem/removeItem 操作,存对象须 JSON 序列化,不支持敏感信息、跨域及自动过期。
LocalStorage 是浏览器提供的一种简单持久化存储方式,适合存少量字符串数据,比如用户偏好、表单草稿、登录状态标识等。它不随页面刷新丢失,但仅限同源(相同协议、域名、端口)访问,且只能存字符串。
所有操作都通过 window.localStorage 对象完成,主要方法有三个:
setItem(key, value),value 会自动转成字符串。例如:localStorage.setItem('theme', 'dark');
getItem(key),返回字符串或 null(键不存在时)。例如:const theme = localStorage.getItem('theme'); // "dark"
removeItem(key) 删除单个键,或 clear() 清空全部。注意:如果要存对象或数组,必须先用 JSON.stringify() 转字符串;读取时再用 JSON.parse() 还原,否则会得到 [object Object] 这类无效结果。
(按字符串长度算),超出会抛出 QuotaExceededError 异常。storage 事件监听(但仅对其他窗口生效,当前窗口修改不会触发自身)。可以简单封装一层,自动处理 JSON 转换和异常:
const storage = {
set(key, value) {
try {
localStorage.setItem(key, JSON.stringify(value));
} catch (e) {
console.warn('LocalStorage 写入失败:', e);
}
},
get(key) {
const str = localStorage.getItem(key);
try {
return str ? JSON.parse(str) : null;
} catch (e) {
return str; // 解析失败就返回原始字符串
}
}
};
这样调用更直观:storage.set('user', { id: 123, name: 'Alice' });,读取也自动还原对象。