「为什么用户刷新一下,购物车就空了?」查代码发现存在 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。

「登录态到底放 Cookie 还是 localStorage」是个老问题。Cookie 设置了 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,恢复时如果发现本地版本比服务端新才提示「有未同步的草稿,是否恢复」,而不是直接覆盖输入框。

三次反馈里只有一次是真正的代码 bug,另外两次是「预期」和「多实例」问题。存储类需求要先说清生命周期和归属,否则代码写得再对,用户还是会觉得「数据丢了」。

现象对照:存储相关的常见故障

你看到的现象更可能的原因第一步查什么
刷新页面后数据还在,关掉标签页再打开就没了用的是 sessionStorage,它只活在当前标签页确认代码里用的是哪个存储对象,别靠记忆
写入时抛 QuotaExceededError,或者静默失败超出容量配额,常见于把图片转 base64 塞进去算一遍写入字符串的长度;大对象换 IndexedDB 或只存地址
页面白屏,报 JSON.parse 的 SyntaxError旧版本写进去的数据结构变了,或者被别的代码写坏读取统一加 try/catch 和默认值;key 带版本号
两个标签页的数据互相覆盖多个页面共用同一个 key,谁最后写谁生效检查 key 是否带业务 id;需要同步时监听 storage 事件
关掉浏览器再打开,登录状态没了Cookie 没设过期时间,属于会话 Cookie,浏览器关闭即失效在 Application 面板看 Cookie 的 Expires,和服务端 Set-Cookie 对照
接口明明登录了,请求却没带 CookieSameSite、Secure、域名或路径不匹配,浏览器不发看请求头里有没有 Cookie;再看该 Cookie 的属性配置

这张表里最容易被误判的是第三条:看到 JSON.parse 报错,很多人第一反应是「浏览器缓存坏了」,实际上是自己的数据结构改过、旧数据没兼容。只要能复现「老用户出问题、新用户正常」,基本就是这个方向。

这些存储的边界与代价

  • 容量别按上限设计。localStorage 通常在几 MB 量级,但各浏览器不完全一致,用户还可能同时开着别的站点占空间。留出余量,并且永远假设「写不进去」是正常分支。
  • 同步读写是有代价的。localStorage 的读写发生在主线程上,几 MB 的对象序列化加写入能让页面卡一下。放进输入框的每次按键回调里,卡顿会非常明显。高频场景要么节流,要么换 IndexedDB。
  • 数据可能被浏览器清掉。用户清缓存、隐私模式、系统存储紧张,都可能让本地数据消失。所以本地存储只能当缓存,重要数据必须落服务端。
  • Cookie 会跟着每个同域请求走。哪怕这个请求根本不需要身份,也会多带几百字节的头。Cookie 越多,请求头越大,全站请求都受影响。别把非必要的信息塞进 Cookie。
  • storage 事件不会在当前页触发。它只在「其他标签页」修改时通知你。想在本页也响应,得自己写一层通知机制。另外它的触发是异步的,不能拿来做强一致的多标签页同步。
  • IndexedDB 的复杂度是真实成本。异步事务、版本升级、错误处理都要自己写,团队里没人熟悉时,出问题的概率比 localStorage 高。数据量不到几十 MB,未必值得。

还有一个经常被忽略的代价:同一浏览器里不同站点共享配额池。你在自己的站点里塞满,可能会影响同浏览器下其他页面的写入,反过来也一样。别把「我这里能存下」当成稳定前提。

当天就能做的四件事

  1. 开两个标签页打开同一个页面,在 A 里执行 localStorage.setItem('t', '1'),在 B 里监听 storage 事件并打印日志,然后再反过来操作一次,观察谁收到了事件。
  2. 写一个循环,往 localStorage 里不断追加字符串直到抛错,打印 err.name 和你实际写进去的大致体积。这个数字比背「5MB」有用。
  3. 在无痕窗口里执行 localStorage.setItem('a', '1'),看是否成功、刷新后是否还在。
  4. 打开 Application 面板的 Cookies 列表,找一个带登录态的站点,看 HttpOnly、Secure、SameSite 这三列分别是什么值,再对照它的请求头。

小结与下一篇

记住这条选择线:要让服务器认出用户,用 Cookie,并考虑 HttpOnly 和 SameSite;存少量偏好和草稿,用 localStorage,但接受它同步、容量小、可能写不进去;只在当前标签页有效的临时状态,用 sessionStorage;数据量大、要结构化查询或存文件,用 IndexedDB。任何时候都假设本地数据会丢、会被清、会被脚本读走。

下一篇读请求、缓存与跨域。原因很直接:这篇里提到的 Cookie 属性、HttpOnly、SameSite,只有放到「请求怎么发出去、跨域时凭证能不能带」的语境里才说得清;那边还会讲缓存头,正好解释你本地改了代码、用户却还是旧文件的问题。

如果只是想先复习请求 API 的写法,回看常用浏览器 API。更细的 Web 安全内容不在基础篇里,属于后续专题。