「为什么用户刷新一下,购物车就空了?」查代码发现存在 sessionStorage 里,换了个标签页打开就没了。还有一个更典型的:有人把接口返回的几百条商品数据序列化后塞进 localStorage,本地测试好好的,线上用户数据多一点就抛 QuotaExceededError,整个页面白屏。
浏览器给了四种常用的存数据方式:Cookie、localStorage、sessionStorage、IndexedDB。它们不是「哪个更高级用哪个」,而是各自解决不同的问题。这篇按「什么时候该用谁」来讲,同时说清每种方式会带来什么麻烦。读完你能做到:给一个需求选出合适的存储,知道容量、生命周期、同步阻塞这些坑在哪。
Cookie:不是给你存业务数据的
Cookie 是最早的浏览器存储,设计目的是让服务器「认出同一个浏览器」。你登录之后,服务器通过响应头下发一个 Cookie,浏览器保存起来;之后访问同一站点时,浏览器会自动把它带在请求头里,服务器读到就知道「还是这个人」。
它有几个绕不开的限制:
- 容量很小,每个 Cookie 通常只有几 KB(各家浏览器略有差异,具体数值待确认)。放个 token 够用,放业务数据就不合适。
- 会自动跟着请求发送。如果同域下有很多大 Cookie,每个请求都背着它们,等于给所有请求增加负担。
- 前端用
document.cookie读写,接口很原始:读到的是一整串字符串,要自己解析;写的时候是拼接一个带属性的字符串。
// 写入:过期时间、路径、SameSite 都要自己拼
document.cookie =
'session=abc123; Max-Age=604800; Path=/; Secure; SameSite=Lax';
// 读取:拿到的是一整串,需要自己拆
function getCookie(name) {
const pairs = document.cookie.split('; ');
for (const pair of pairs) {
const [key, value] = pair.split('=');
if (key === name) return decodeURIComponent(value);
}
return null;
}
几个属性值得记住:HttpOnly 的 Cookie 前端 JS 读不到,只有服务器能设置,用来防 XSS 直接偷登录凭证;Secure 只在 HTTPS 下发送;SameSite 控制跨站请求要不要带上它,Lax 是现在比较常用的默认值,None 必须配合 Secure。
HttpOnly 之后,即使页面被注入脚本,脚本也读不到凭证;localStorage 里的 token 一旦有 XSS 就能被直接读走。具体怎么选还涉及 CSRF 防护和服务端架构,不是一句「用 Cookie 更安全」能说完的。localStorage:简单、同步、会一直留着
localStorage 是最顺手的:键值对、只存字符串、按域名隔离、除非用户或代码主动清除,否则一直留着。放主题偏好、语言设置、草稿这类小数据很合适。
// 只能存字符串,对象要自己序列化
const settings = { theme: 'dark', fontSize: 16 };
localStorage.setItem('settings', JSON.stringify(settings));
const raw = localStorage.getItem('settings');
let parsed = {};
try {
parsed = raw ? JSON.parse(raw) : {};
} catch (err) {
localStorage.removeItem('settings'); // 数据坏了,别让页面跟着崩
}
三个坑要提前知道:
- 它是同步的。读写会占用主线程,存几十 KB 感觉不到,存几 MB 就会明显卡一下。别在滚动、输入这种高频路径上反复读写。
- 容量有限。通常每个域名几 MB(不同浏览器有差异,具体值待确认),超了会抛
QuotaExceededError。用之前最好try/catch包一下,不然整个初始化流程会中断。 - 不是所有环境都可用。隐私模式、禁用了存储的浏览器、被策略限制的嵌入页面里,访问它可能直接抛错。所以「写完就一定成功」这个假设不成立。
它有一个还算好用的事件:同源的其他标签页修改了 localStorage 时,当前页会收到 storage 事件。注意是「其他标签页」,当前页自己改不会触发。可以用它做多标签状态同步,但别指望它传大数据。
sessionStorage:只活在当前这个标签页
sessionStorage 的 API 和 localStorage 一模一样,区别在生命周期:它跟着「标签页会话」走,刷新页面还在,关掉标签页就没了,也不和其他标签页共享。适合放「这次操作过程中的临时状态」,比如多步表单的中间数据、页面内的筛选条件。
开头的购物车问题就是选错了:用户希望换标签页也能看到购物车,那至少要用 localStorage,更正规的做法是把购物车放在服务端,本地只存一个标识。用 sessionStorage 存「需要跨标签页延续」的东西,注定会丢。
IndexedDB:给大量结构化数据用的
IndexedDB 是浏览器里的一个小型数据库:能存大量数据、能存对象和二进制(Blob)、支持索引和事务、读写是异步的。离线应用缓存文章、图片,或者本地保存上万条记录,应该用它。
代价是 API 比较啰嗦。下面是最小可用的打开与读写流程,你能看出它为什么通常要配一个封装库:
const request = indexedDB.open('notes-db', 1);
request.onupgradeneeded = () => {
const db = request.result;
if (!db.objectStoreNames.contains('notes')) {
db.createObjectStore('notes', { keyPath: 'id' });
}
};
request.onsuccess = () => {
const db = request.result;
const tx = db.transaction('notes', 'readwrite');
const store = tx.objectStore('notes');
store.put({ id: 1, title: '会议记录', updatedAt: Date.now() });
tx.oncomplete = () => console.log('写入完成');
tx.onerror = () => console.error('写入失败', tx.error);
};
Queue、事务、版本升级这些概念都要理解一点,随手上手容易写出「异步顺序错乱」的代码。数据量不大时,硬上 IndexedDB 是过度设计;数据量大了还用 localStorage,是在给主线程找麻烦。
四种方式放一张表里看
| 方式 | 适合存什么 | 容量量级 | 生命周期 | 读写方式 | 随请求发送 |
|---|---|---|---|---|---|
| Cookie | 登录凭证、少量标识 | 几 KB | 按 Max-Age/Expires,不设则随浏览器会话 | 同步,接口原始 | 是,同域请求自动带 |
| localStorage | 偏好设置、草稿、少量缓存 | 几 MB | 一直保留,直到清除 | 同步 | 否 |
| sessionStorage | 当前标签页的临时状态 | 几 MB | 关闭标签页即清 | 同步 | 否 |
| IndexedDB | 大量结构化数据、二进制文件 | 较大,受浏览器配额限制 | 一直保留,直到清除 | 异步 | 否 |
选型时先问三个问题:数据要不要跨标签页、跨重启保留?数据有多大?读写会不会发生在高频路径上?三个答案基本就能定下来。容量数字各家浏览器有差异,不要按表里的上限做设计,留出余量。
真实项目里最常见的几类事故
下面这些都不是理论问题,是在项目里反复出现的:
- 把文件塞进 localStorage:图片转成 base64 存进去,一张就可能超过容量。正确做法是把文件存 IndexedDB,或者干脆上传到服务端只存地址。
- 直接
JSON.parse(localStorage.getItem(key)):第一次访问没有值,getItem返回null,JSON.parse(null)得到null还好;但数据被其他版本写坏时就会抛错,整个页面停在这里。统一封一个读写函数,内部try/catch并给默认值。 - 多标签页互相覆盖:用户在两个标签页同时编辑,最后写入的覆盖前面的。要么用
storage事件做同步,要么加更新时间判断,要么接受「以最后一次为准」并明确提示用户。 - 版本升级没清理旧数据:字段改名、结构变化,旧数据还在,新代码读到就出错。给 key 加版本前缀,或者在读取时校验字段是否完整。
- 隐私模式下写入失败:某些环境下
setItem直接抛错。所有写操作都该有兜底,存不进去至少不能让主流程崩掉。
安全:别把敏感数据放心地放进去
先说清楚一个事实:localStorage 和 sessionStorage 里的内容,页面上的任何脚本都能读。只要页面存在 XSS(攻击者往页面里注入了脚本),存进去的 token、用户信息就能被打包发走。加密再存也没用,因为解密代码也在同一个页面里。
所以敏感凭证优先考虑 HttpOnly Cookie:脚本读不到,能挡住「直接偷 token」这一类攻击。但它会带来另一个问题 CSRF(跨站请求伪造):浏览器会自动带 Cookie,别的网站就能借用户的登录态发请求。防法是 SameSite 属性加上服务端的 CSRF token 校验。这两件事要一起考虑,只做一半等于没做。
不管用哪种存储,都别放密码、身份证号、完整的支付信息。前端存储不是一个安全的地方,它更像「用户电脑上的便签」,能省一次请求,但不能承担保密责任。
走一遍真实排查:草稿功能把页面搞白了
一个内容编辑页,表单很长,产品要求「每五秒自动存草稿,刷新后能恢复」。实现很直接:把整个表单对象 JSON.stringify 之后写进 localStorage,进页面时读出来填回去。
第一起反馈:草稿丢了。用户说「写了一半,刷新就没了」。第一反应是 key 写错了或者写到了 sessionStorage。检查代码,key 一致,用的也是 localStorage。再问细节:用户是换了台电脑继续写。到这里就不是 bug 了,是预期没说清——本地存储只在这台设备这个浏览器里,换设备当然没有。产品文案后来改成了「草稿仅保存在当前浏览器」。
第二起反馈:页面白屏。这次不是丢数据,是打开编辑页直接空白,控制台一条 Uncaught DOMException: Failed to execute 'setItem' on 'Storage'。原因是用户把几张图片粘贴进了富文本,图片被转成 base64 一起塞进草稿,单条记录超过了容量上限。写入抛错,而这段写入发生在渲染流程里,异常一抛,后面的渲染代码没执行,页面就白了。
为什么之前没发现。开发时用的测试数据全是纯文字,几百 KB 都不到,永远碰不到上限。这类问题只在「真实用户上传了图片」时出现,属于典型的「本地测不出来」。
改法分三层。第一层,所有写入套 try/catch,失败时提示「草稿保存失败,请手动复制内容」,不能让它打断渲染;第二层,草稿只存纯文本和图片地址,图片本体走上传,不塞进 localStorage;第三层,草稿超过一定体积就转存 IndexedDB,那里容量大得多,也不会同步阻塞主线程。
function saveDraft(key, value) {
const text = JSON.stringify(value);
try {
localStorage.setItem(key, text);
return true;
} catch (err) {
// 容量超限或隐私模式禁写,都会走到这里
console.warn('草稿写入失败', err.name);
return false;
}
}
第三起反馈:两个人用同一台电脑。客服和运营共用一台机器,两个标签页编辑不同文章,结果 A 的草稿覆盖了 B 的。原因是 key 只用了固定的 draft,没带文章 id。改成按文章 id 分 key,再给每条草稿加 updatedAt,恢复时如果发现本地版本比服务端新才提示「有未同步的草稿,是否恢复」,而不是直接覆盖输入框。
现象对照:存储相关的常见故障
| 你看到的现象 | 更可能的原因 | 第一步查什么 |
|---|---|---|
| 刷新页面后数据还在,关掉标签页再打开就没了 | 用的是 sessionStorage,它只活在当前标签页 | 确认代码里用的是哪个存储对象,别靠记忆 |
写入时抛 QuotaExceededError,或者静默失败 | 超出容量配额,常见于把图片转 base64 塞进去 | 算一遍写入字符串的长度;大对象换 IndexedDB 或只存地址 |
页面白屏,报 JSON.parse 的 SyntaxError | 旧版本写进去的数据结构变了,或者被别的代码写坏 | 读取统一加 try/catch 和默认值;key 带版本号 |
| 两个标签页的数据互相覆盖 | 多个页面共用同一个 key,谁最后写谁生效 | 检查 key 是否带业务 id;需要同步时监听 storage 事件 |
| 关掉浏览器再打开,登录状态没了 | Cookie 没设过期时间,属于会话 Cookie,浏览器关闭即失效 | 在 Application 面板看 Cookie 的 Expires,和服务端 Set-Cookie 对照 |
| 接口明明登录了,请求却没带 Cookie | SameSite、Secure、域名或路径不匹配,浏览器不发 | 看请求头里有没有 Cookie;再看该 Cookie 的属性配置 |
这张表里最容易被误判的是第三条:看到 JSON.parse 报错,很多人第一反应是「浏览器缓存坏了」,实际上是自己的数据结构改过、旧数据没兼容。只要能复现「老用户出问题、新用户正常」,基本就是这个方向。
这些存储的边界与代价
- 容量别按上限设计。localStorage 通常在几 MB 量级,但各浏览器不完全一致,用户还可能同时开着别的站点占空间。留出余量,并且永远假设「写不进去」是正常分支。
- 同步读写是有代价的。localStorage 的读写发生在主线程上,几 MB 的对象序列化加写入能让页面卡一下。放进输入框的每次按键回调里,卡顿会非常明显。高频场景要么节流,要么换 IndexedDB。
- 数据可能被浏览器清掉。用户清缓存、隐私模式、系统存储紧张,都可能让本地数据消失。所以本地存储只能当缓存,重要数据必须落服务端。
- Cookie 会跟着每个同域请求走。哪怕这个请求根本不需要身份,也会多带几百字节的头。Cookie 越多,请求头越大,全站请求都受影响。别把非必要的信息塞进 Cookie。
storage事件不会在当前页触发。它只在「其他标签页」修改时通知你。想在本页也响应,得自己写一层通知机制。另外它的触发是异步的,不能拿来做强一致的多标签页同步。- IndexedDB 的复杂度是真实成本。异步事务、版本升级、错误处理都要自己写,团队里没人熟悉时,出问题的概率比 localStorage 高。数据量不到几十 MB,未必值得。
还有一个经常被忽略的代价:同一浏览器里不同站点共享配额池。你在自己的站点里塞满,可能会影响同浏览器下其他页面的写入,反过来也一样。别把「我这里能存下」当成稳定前提。
当天就能做的四件事
- 开两个标签页打开同一个页面,在 A 里执行
localStorage.setItem('t', '1'),在 B 里监听storage事件并打印日志,然后再反过来操作一次,观察谁收到了事件。 - 写一个循环,往 localStorage 里不断追加字符串直到抛错,打印
err.name和你实际写进去的大致体积。这个数字比背「5MB」有用。 - 在无痕窗口里执行
localStorage.setItem('a', '1'),看是否成功、刷新后是否还在。 - 打开 Application 面板的 Cookies 列表,找一个带登录态的站点,看
HttpOnly、Secure、SameSite这三列分别是什么值,再对照它的请求头。
小结与下一篇
记住这条选择线:要让服务器认出用户,用 Cookie,并考虑 HttpOnly 和 SameSite;存少量偏好和草稿,用 localStorage,但接受它同步、容量小、可能写不进去;只在当前标签页有效的临时状态,用 sessionStorage;数据量大、要结构化查询或存文件,用 IndexedDB。任何时候都假设本地数据会丢、会被清、会被脚本读走。
下一篇读请求、缓存与跨域。原因很直接:这篇里提到的 Cookie 属性、HttpOnly、SameSite,只有放到「请求怎么发出去、跨域时凭证能不能带」的语境里才说得清;那边还会讲缓存头,正好解释你本地改了代码、用户却还是旧文件的问题。
如果只是想先复习请求 API 的写法,回看常用浏览器 API。更细的 Web 安全内容不在基础篇里,属于后续专题。