localStorage数据永久保存(关浏览器不丢失),sessionStorage仅限当前标签页(关tab即清空);二者均只支持字符串,存对象需JSON.stringify,取时需JSON.parse;同源下localStorage全局共享,sessionStorage隔离;均不参与HTTP请求。
关键区别就一条:localStorage 数据关掉浏览器也不丢,sessionStorage 关掉当前标签页就清空。不是“关浏览器”,而是“关那个页面标签”——哪怕你刷新、跳转、开新窗口,只要没关掉这个 tab,sessionStorage 就还在;但新开一个同域名的 tab,它的 sessionStorage 是完全独立的,互不可见。
localStorage 适合存长期有效的数据:用户主题、记住的搜索词、登录后返回的 token(⚠️注意:不推荐存敏感 token,见下文)sessionStorage 适合存临时中转状态:多步表单的第 2 步数据、从列表页传到详
情页的 id、防重复提交的标记cookie 本质不同因为二者只接受字符串——存数字自动转成字符串,存对象却变成 "[object Object]",取出来就废了。必须手动序列化。
const user = { name: "小明", age: 28 };
// ✅ 正确:存前 JSON.stringify
localStorage.setItem("user", JSON.stringify(user));
// ✅ 正确:取后 JSON.parse
const savedUser = JSON.parse(localStorage.getItem("user"));
console.log(savedUser.name); // "小明"
JSON.stringify,getItem 返回的永远是 "[object Object]",不是报错,而是静默失败JSON.parse(null) 会报错,所以建议加一层判断:const data = localStorage.getItem("key"); return data ? JSON.parse(data) : null;
null、undefined 存进去也会被转成字符串,读取时需自行转换类型localStorage 同源(协议+域名+端口)下所有页面都能读写,改一个,其他页面立刻可见;sessionStorage 则严格绑定当前 tab,新开 tab 就是全新沙盒。
localStorage 做“全局状态同步”要小心:A 页面改了 theme,B 页面不会自动响应——得监听 storage 事件才能感知变化sessionStorage 在 iframe 里也独立,父子页面之间不能靠它传数据localStorage,getItem 返回 null,setItem 可能抛 QuotaExceededError
别把密码、身份证号、完整 token 往里塞——XSS 攻击能直接读走,毫无防护。
if (!window.localStorage) { /* fallback */ }
localStorage.clear() 是全站清除,不是当前页面——上线前务必确认是否影响其他模块最常被忽略的一点:你以为存了个对象,其实只存了一串字符串;你以为关了浏览器数据就没了,结果 localStorage 还在那儿等着你下次打开——用之前,先想清楚“它到底活多久”“谁能看到它”“它是不是真该放这儿”。