Published on

当两个标签页同时写入 LocalStorage

把主题写进 localStorage,刷新后就能读回来。用它保存这么一个值很顺手,拿它做跨标签页的计数器却容易出错:两个页面各加一次,结果可能只加了一次。要理解这个差别,可以先看一次 setItem() 承诺了什么,再看两个页面同时做几步操作时会发生什么。

基本特性与常用操作

网页通过 window.localStorage 取得一个 Storage 对象。键和值都是字符串,找不到某个键时,getItem() 返回 null。保存对象需要自己序列化,读取时也要处理旧格式或解析失败。

const themeKey = 'preferences:theme'

localStorage.setItem(themeKey, 'dark')
const theme = localStorage.getItem(themeKey) ?? 'light'
localStorage.removeItem(themeKey)
特性实际行为
作用域普通同源页面可以访问同一片存储。源由协议、主机和端口决定,嵌入式第三方场景还可能按顶层站点分区。
生命周期重载页面和关闭普通标签页后通常仍在。用户清理数据、隐私策略或浏览器回收都可能让数据消失。
配额Web Storage 的额度只有几 MiB 量级,写满时会抛出 QuotaExceededError。使用时要能接受保存失败。
执行环境API 在 Window 上同步执行,Web Worker 中没有 localStorage。

页面访问存储受到浏览器策略限制时,连读取 window.localStorage 本身都可能抛出 SecurityError。如果只是主题偏好,可以让页面退回默认主题,用户仍然可以使用页面。(HTML Web Storage 规范、Chrome 存储分区说明)

同步调用与后台落盘

下面这行把序列化和存储写在了一起。数据越大,在主线程上执行的工作就越多。

localStorage.setItem('drafts', JSON.stringify(drafts))

执行顺序是先跑完 JSON.stringify(),再同步调用 setItem()。输入框每打一字就重写整份草稿列表,会把这两段工作一起放进输入事件。读取已有数据时也一样,getItem() 和 JSON.parse() 都在当前调用栈中完成。可以先合并高频更新,再用 DevTools 的 Performance 面板确认耗时究竟来自序列化、存储调用,还是同一事件里的其他代码。

LocalStorage 的底层实现

以 Chromium 为例,V8 执行网页脚本,Blink 提供 Storage 的接口和缓存,渲染器通过 Mojo 向浏览器的 DOM Storage 后端提交操作。后端负责组织存储区和持久化。网页看到的是同步接口,缓存、进程通信以及后台提交是浏览器内部的工作。

页面调用 setItem()
    ↓ V8 执行脚本,Blink 处理 Storage 调用
渲染器侧存储区缓存
    ↓ Mojo
浏览器 DOM Storage 后端
    ↓
浏览器配置目录中的持久化存储

数据存储路径与文件格式

在使用 LevelDB 的 Linux Chromium 配置中,默认用户资料下可能看到这样的目录。

~/.config/chromium/Default/Local Storage/leveldb/

存储键可以作为底层记录的一部分,多个源的数据也可以放在同一份数据库里。网页端字符串可以按 UTF-16 代码单元理解,Chromium 的历史实现则区分过 Latin-1 和 UTF-16 两种存储编码。比如你保存 JSON 时,那只是你选用的字符串格式。底层目录、编码和后端由浏览器版本与配置决定。调试时,用 DevTools 的 Application → Local Storage 就能直接查看网页读到的键值。(Blink 存储区缓存、Chromium DOM Storage 后端、Chromium 历史版本的记录与编码)

浏览器可以调度缓存提交和后台落盘,网页仍要为每次同步调用付出主线程时间。Web Storage 也没有规定一个可依赖的「每秒写入次数」。比起猜浏览器何时限频,更有效的是减少重复写入。

多标签页和窗口的同步机制

一个标签页改了值,共享同一存储区的其他文档可以收到 storage 事件。发起写入的页面应直接更新自己的界面。另一个页面收到事件后,可以用 event.key 判断修改范围,再读最新值。调用 clear() 时,事件的 key 为 null。

function syncTheme() {
  const theme = localStorage.getItem('preferences:theme') ?? 'light'
  document.documentElement.dataset.theme = theme
}

window.addEventListener('storage', (event) => {
  if (event.storageArea !== localStorage) return
  if (event.key === 'preferences:theme' || event.key === null) syncTheme()
})

function setTheme(theme) {
  localStorage.setItem('preferences:theme', theme)
  syncTheme()
}

线程安全与锁机制

Chromium 按存储键管理存储区域,具体版本中能看到 StorageAreaImpl、LocalStorageImpl 等后端对象。多进程间的 IPC、缓存更新与后台提交保证浏览器能够管理共享存储。应用需要的跨步骤一致性,还要回到几次 JavaScript 调用之间判断。

改主题时,最后成功写入的偏好值往往就够用了。累加计数则不同。假设两个标签页都做 getItem() → 加一 → setItem(),它们可能先后读到同一个旧值,再分别写入同一个新值。事件能告诉另一个页面发生过写入,无法把三步变成一个原子操作。

时刻标签页 A标签页 B
读取读到 10读到 10
计算算出 11算出 11
写入写入 11也写入 11

HTML 规范建议应用按没有跨页面锁来设计。只要最终结果依赖「我读的旧值在写入前不能变」,就需要事务或额外的协调机制。比如累计本地操作次数,可以把读和写放进同一个 IndexedDB 写事务。(HTML 规范关于共享状态的说明)

过期、清理和敏感数据

localStorage 没有按键设置有效期的 API。需要缓存时,可以把过期时间和数据一起保存。读取侧对旧格式、过期或不可访问的记录用同一个默认值处理。

localStorage.setItem(
  'preferences:cached-language',
  JSON.stringify({ value: 'zh-CN', expiresAt: Date.now() + 60_000 })
)

function readCachedValue(key) {
  try {
    const raw = localStorage.getItem(key)
    if (raw === null) return null

    const entry = JSON.parse(raw)
    return Number.isFinite(entry?.expiresAt) && Date.now() < entry.expiresAt ? entry.value : null
  } catch {
    return null
  }
}

const language = readCachedValue('preferences:cached-language') ?? 'en'

这个例子只会忽略过期值。清理可以由写入方定期处理,避免读取方拿着一份旧记录去删除刚被另一个页面更新的值。删除键的作用是让网页无法再通过该键读取数据。浏览器的日志、备份和底层文件如何清理,不属于 removeItem() 的保证。

安全性分析

同源脚本能读写 localStorage。如果页面发生 XSS,攻击脚本也能在这个源里运行。浏览器端的 API 没有 HttpOnly 这一层保护。主题、语言和界面布局适合保存在这里。会话凭据如果由服务端通过 HttpOnly Cookie 管理,可以避免脚本直接读取 Cookie 值,但页面仍需防范 XSS。(HTML Web Storage 安全性说明、RFC 6265 的 HttpOnly 属性)

问题使用时的影响
XSS 与同源脚本访问能在当前源中执行的脚本可以读写这些数据
缺少 HttpOnly 属性无法为某个键关闭 JavaScript 访问
没有内建过期时间需要由应用判断有效期并安排清理
删除后的底层清理删除键后无法再通过 API 读取,磁盘文件、日志和备份的处理由浏览器与系统负责

性能问题与限制

限制对应用的影响
同步调用频繁读写和大数据序列化会占用页面主线程
字符串键值对象要自行转换,读取时要处理格式变更与解析错误
配额和访问策略写入可能失败,读取存储对象本身也可能受策略限制
缺少事务与索引多键更新和读改写需要额外设计,查询通常依赖应用自己组织数据

按数据的用途选存储

存储范围和生命周期调用方式和容量适合保存
localStorage同一存储区内共享,重载后通常仍在同步,几 MiB 量级少量、低频更新的偏好
sessionStorage按源和顶层浏览上下文隔离,通常随标签页会话结束而清理同步,几 MiB 量级单个标签页里的临时步骤
IndexedDB按存储区隔离,数据通常跨会话保留,也可能随配额政策被回收异步,配额通常更大,支持索引和事务大量结构化数据、离线草稿和并发更新
Cookie按域名、路径等属性匹配,可设置到期时间document.cookie 是同步接口,单条 Cookie 通常只有几 KiB随请求发送给服务端的少量会话数据

可以先问一个实际的问题:这份数据丢了,页面还能不能正常工作?对于能回退默认值的小偏好,localStorage 的简单最有价值。需要查找大量记录、同时写多条数据,或者让读改写成为一次完整操作时,IndexedDB 的事务更合适。

最佳实践

localStorage 的优势是 API 简单、浏览器支持广,保存少量偏好时容易接入。让这些特点发挥作用,可以把读写频率和失败处理一起考虑。

  • 主题、语言等轻量偏好用独立键保存,并为读取失败准备默认值。
  • 合并输入过程中的高频写入,避免每次都序列化整份大对象。
  • 为缓存记录有效期,同时安排清理,避免过期记录一直占用配额。
  • 保存敏感数据前检查同源脚本的访问范围,会话凭据结合服务端 Cookie 机制设计。
  • 需要索引查询或原子更新时,用 IndexedDB 的对象仓库和事务表达数据关系。