
缓存用户偏好、离线草稿和接口结果时,很多人在 Cookie、localStorage、IndexedDB 之间凭手感挑。三种前端本地存储方案各有分工,选错会让请求头被撑大或让主线程卡住。
一、三种存储的容量边界与定位
1. Cookie:随请求自动发送的小容量存储
Cookie 每个域名下总量约 4KB,同源请求会自动带上它,适合承载会话标识这类服务端要读的小数据。
2. Web Storage:同步的键值存储
localStorage 与 sessionStorage 都以字符串键值对保存数据,单域名容量约 5MB。前者除非手动删除否则长期保留,后者随标签页关闭清空。
二、Cookie 与 Web Storage 的读写实践
1. localStorage 的封装与过期控制
localStorage 只能存字符串,存取对象要手动序列化,封装带过期时间的读写函数即可。
const store = {
set: (k, v, ttl) => localStorage.setItem(k, JSON.stringify({ v, t: Date.now() + (ttl || 0) })),
get: (k) => {
const { v, t } = JSON.parse(localStorage.getItem(k) || "{}");
return t && Date.now() > t ? (localStorage.removeItem(k), null) : v ?? null;
}
};
t 字段存过期时间戳,读取时判断即可。
2. Cookie 的写入与读取要点
Cookie 没有对象 API,需用 document.cookie 拼接,写入时用 max-age 控制有效期。写入的值必须 encodeURIComponent,否则遇到分号会被截断。
三、IndexedDB 处理结构化大数据
1. 打开数据库与建表
数据量到几十 MB、或需按索引检索记录时,localStorage 不再合适。IndexedDB 异步且支持事务与索引,建表与建索引在 onupgradeneeded 回调里完成。
2. 事务读写与游标遍历
读写都通过事务。取数时指定索引,用游标倒序读取,无需载入整表:
const openDB = () => new Promise(res => {
const q = indexedDB.open("blog", 1);
q.onupgradeneeded = e => e.target.result
.createObjectStore("drafts", { keyPath: "id" }).createIndex("t", "t");
q.onsuccess = () => res(q.result);
});
const listDrafts = async () => {
const idx = (await openDB()).transaction("drafts").objectStore("drafts").index("t");
const out = [];
await new Promise(done => {
idx.openCursor(null, "prev").onsuccess = e => {
const c = e.target.result;
c ? (out.push(c.value), c.continue()) : done();
};
});
return out;
};
关键配置提示
- 小于 4KB 且服务端要读:用 Cookie,敏感项加 HttpOnly 与 Secure。
- 5MB 以内的键值缓存:用 localStorage,包一层过期逻辑。
- 几十 MB 的结构化数据:用 IndexedDB,建索引后用游标分页。
- 任何存储都受同源策略约束,跨域页面无法互相读取。

快来评论,快来抢沙发吧~