1 / 4概念
Storage
浏览器给页面五种持久化位置,各有作用域、生命周期、容量与访问方式。判断标准不是记住 API,而是能否说清这份数据该放哪、什么时候失效、被谁读得到。
1 概念
1.1 一句话定义
Cookie 随请求自动发送、容量最小;本地与会话存储是同步键值对;IndexedDB 是异步事务型数据库;Cache 存响应对象。它们都按同源隔离,都在配额与驱逐规则下。
1.2 它解决什么问题
- 免请求保存:主题、草稿、上次位置不占带宽。
- 会话保持:登录状态在页面间延续。
- 离线与加速:结构化数据与响应可缓存。
- 跨标签同步:同一用户的多个页面看到一致状态。
1.3 不属于本页的内容
| 主题 | 去哪 |
|---|---|
| 渲染与布局 | Rendering Pipeline |
| 请求、缓存头、同源策略 | Navigation and Network |
| 服务端数据库与事务 | Data 章 |
| 鉴权与 XSS 防护 | Web Security |
| 对象序列化细节 | Objects and Prototypes |
1.4 关键术语
| 术语 | 含义 | 容易混淆的点 |
|---|---|---|
| 同源 | 协议、主机、端口相同 | 端口不同也不同源 |
| Cookie | 随请求发送的小段数据 | 可设 HttpOnly |
| 会话存储 | 按标签页隔离 | 关闭标签即清 |
| 本地存储 | 同步键值对 | 永久直到清除 |
| IndexedDB | 异步对象数据库 | 不是 SQL |
| Cache Storage | 存响应对象 | 由脚本控制 |
| 配额 | 可用存储上限 | 按磁盘与站点分配 |
| 驱逐 | 空间不足时删除 | 无痕模式更激进 |
| 分区 | 按顶层站点隔离 | 影响第三方嵌入 |
2 机制
2.1 心智模型
先问三个问题:需不需要随请求发送,需不需要跨标签,需不需要存结构化大数据。答案依次指向 Cookie、本地或会话存储、IndexedDB 与 Cache。
2.2 机制拆解
- Cookie:每个请求自动携带,容量约 4 KB,受域名与路径限制;
HttpOnly禁止脚本读取,Secure只走 HTTPS。 - SameSite:
Lax默认,跨站GET导航会发送;Strict完全隔离;None必须配Secure。 - 本地存储:同步 API,字符串键值,容量数 MB;同源共享,
storage事件在其他标签页触发。 - 会话存储:按标签页隔离,关闭即清;复制标签页会复制一份。
- IndexedDB:异步、事务、支持索引与游标;版本升级在
onupgradeneeded里完成。 - Cache Storage:存
Response,配合 Service Worker 实现离线与策略缓存。 - 配额:
navigator.storage.estimate()给用量与上限,persist()申请免驱逐;空间不足时按策略驱逐。 - 序列化:本地存储只能存字符串,对象要
JSON.stringify;IndexedDB 用结构化克隆,能存Date、Blob、Map。
2.3 完整枚举
五种存储的对比:
| 位置 | 容量 | 生命周期 | 访问方式 | 随请求发送 |
|---|---|---|---|---|
| Cookie | 约 4 KB | 可设过期时间 | 同步 | 是 |
| 本地存储 | 数 MB | 直到清除 | 同步 | 否 |
| 会话存储 | 数 MB | 标签页关闭 | 同步 | 否 |
| IndexedDB | 数百 MB 级 | 直到清除或驱逐 | 异步 | 否 |
| Cache | 受配额 | 直到清除或驱逐 | 异步 | 否 |
Cookie 的属性:
| 属性 | 作用 |
|---|---|
Domain | 生效的域 |
Path | 生效的路径 |
Max-Age | 相对过期时间 |
Expires | 绝对过期时间 |
Secure | 仅 HTTPS |
HttpOnly | 脚本不可读 |
SameSite | 跨站发送策略 |
SameSite 的三个取值:
| 取值 | 跨站请求 | 场景 |
|---|---|---|
Strict | 从不发送 | 高敏感操作 |
Lax | 顶层导航的 GET 发送 | 默认,登录态 |
None | 总是发送 | 必须配 Secure |
配额与驱逐:
| 机制 | 行为 |
|---|---|
estimate() | 返回用量与上限 |
persist() | 申请免驱逐 |
| 驱逐顺序 | 按最近使用与来源 |
| 无痕模式 | 配额极小,关闭即清 |
2.4 关键数字与量级
| 指标 | 量级 | 说明 |
|---|---|---|
| Cookie 单条 | 约 4 KB | 超出被截断 |
| Cookie 总数 | 每域数十条 | 超限淘汰 |
| 本地存储 | 5 到 10 MB | 浏览器不同 |
| IndexedDB 配额 | 可用磁盘的一定比例 | 按站点分配 |
| 请求头体积 | 每请求都要带 Cookie | 影响首字节 |
3 实践
3.1 最小示例
IndexedDB 的最小读写:打开、建表、事务写入、读取。
function openDatabase() {
return new Promise((resolve, reject) => {
const request = indexedDB.open('notes', 1);
request.onupgradeneeded = () => {
const db = request.result;
if (!db.objectStoreNames.contains('notes')) {
db.createObjectStore('notes', {keyPath: 'id'});
}
};
request.onsuccess = () => resolve(request.result);
request.onerror = () => reject(request.error);
});
}
async function saveNote(note) {
const db = await openDatabase();
await new Promise((resolve, reject) => {
const tx = db.transaction('notes', 'readwrite');
tx.objectStore('notes').put(note);
tx.oncomplete = () => resolve();
tx.onerror = () => reject(tx.error);
});
}
追踪:open 触发升级回调,建好对象仓库;写入在一个读写事务里完成,oncomplete 表示已提交,onerror 表示回滚。事务是原子的,中途失败不会留下半条记录。
3.2 常用操作与参数
| 操作 | 写法 | 说明 |
|---|---|---|
| 读写本地 | localStorage.getItem 与 setItem | 同步,注意阻塞 |
| 监听同步 | window.addEventListener('storage') | 其他标签页触发 |
| 广播 | BroadcastChannel | 同源页面互发消息 |
| 估算配额 | navigator.storage.estimate() | 判断是否接近上限 |
| 申请持久 | navigator.storage.persist() | 降低被驱逐概率 |
| 清理 | 逐键删除或清空 | 退出登录时执行 |
| 序列化 | JSON.stringify | 本地存储只能存字符串 |
| 结构化 | IndexedDB 直接存对象 | 无需手动序列化 |
3.3 标准流程
- 先判断数据是否需要随请求发送,需要就是 Cookie。
- 再判断是否需要跨标签共享,需要就是本地存储或 IndexedDB。
- 数据超过几 MB 或需要索引,就用 IndexedDB。
- 定版本与迁移策略,升级回调里写清楚每一步。
- 处理配额与异常:写入失败要有降级。
- 退出登录时清理敏感数据,别只清服务端会话。
3.4 与相邻技术的组合
- 网络:Cookie 影响每个请求,缓存影响命中率。
- 安全:令牌放
HttpOnlyCookie 可挡脚本读取,但要防 CSRF。 - 渲染:同步存储读写会阻塞主线程,别在渲染热路径里用。
- 对象:结构化克隆支持的类型有限,函数与 DOM 节点不能存。
- Service Worker:Cache 与 IndexedDB 是离线策略的两块基石。
3.5 选型维度
| 维度 | 取值 | 影响 |
|---|---|---|
| 位置 | Cookie / 本地 / 会话 / IndexedDB / Cache | 生命周期与容量 |
| 令牌 | Cookie / 内存 | XSS 与 CSRF 权衡 |
| 同步 | 同步 / 异步 | 主线程阻塞 |
| 持久性 | 会话 / 长期 / 可驱逐 | 数据可靠性 |
3.6 决策规则
- 会话令牌优先放
HttpOnly+Secure+SameSite=Lax的 Cookie。 - 不接受把长期令牌放本地存储,脚本可读即 XSS 可拿。
- 超过一兆的数据或需要查询的数据放 IndexedDB。
- 本地存储只放非敏感的小配置,并包一层异常处理。
- 任何存储都要有版本号,升级时清理旧格式。
- 敏感数据在退出时主动清除,不能依赖用户手动清缓存。
3.7 替代方案对比
| 方案 | 优势 | 代价 | 适用 |
|---|---|---|---|
| Cookie | 自动随请求、可 HttpOnly | 容量小、占带宽 | 会话 |
| 本地存储 | 简单、同步 | 阻塞、可被脚本读 | 偏好设置 |
| 会话存储 | 天然隔离 | 关闭即丢 | 单次流程草稿 |
| IndexedDB | 大容量、事务、索引 | 异步、API 冗长 | 离线数据 |
| Cache | 直接存响应 | 需要 Service Worker | 静态资源 |
| 内存 | 最快、最安全 | 刷新即丢 | 短期状态 |
3.8 何时不该用
- 不要在本地存储里放密码、令牌、个人敏感数据。
- 不要用 Cookie 存大对象,每请求都会带上。
- 不要在渲染回调里同步读写大批量存储。
- 不要假设存储一定成功,无痕模式与配额都会失败。
- 不要用 IndexedDB 存函数或 DOM 节点。
4 边界
4.1 典型故障
| 症状 | 根因 | 处理 |
|---|---|---|
| 令牌被脚本读走 | 存在本地存储 | 改 HttpOnly Cookie |
| 写入抛异常 | 配额不足或无痕模式 | 捕获并降级 |
| 多标签页状态不一致 | 未监听 storage | 监听或广播 |
| 升级后读不出数据 | 结构变更无迁移 | 版本号与迁移 |
| 跨站请求丢失登录态 | SameSite 策略 | 调整或改同站部署 |
| 缓存永远不更新 | 缓存策略无失效 | 版本化文件名 |
| 请求头过大 | Cookie 太多太大 | 精简 |
4.2 反模式
| 做法 | 后果 | 替代 |
|---|---|---|
| 令牌进本地存储 | XSS 直接窃取 | HttpOnly Cookie |
| 存敏感数据不清理 | 泄露风险 | 退出时清除 |
| 用本地存储做数据库 | 容量与性能双输 | IndexedDB |
| 同步读写大对象 | 主线程卡顿 | 异步存储 |
| 无版本号 | 无法迁移 | 加版本 |
4.3 可观测信号
存储用量与增长率、写入失败次数、驱逐事件、缓存命中率、跨标签同步延迟、退出登录后的残留数据。
4.4 安全 / 性能 / 一致性边界
- 信任边界:浏览器存储对同源脚本完全开放,任何 XSS 都能读取非
HttpOnly数据。 - 容量边界:配额按站点分配,接近上限时写入会失败,必须有降级路径。
- 阻塞边界:本地存储是同步 IO,批量读写会阻塞渲染与交互。
- 一致边界:多标签页各自持有副本,需要显式同步,否则用户会看到两种状态。