单页应用的路由状态持久化:2400px 归零、5 MB 配额,和 64 MB 的 history.state
单页应用的路由状态持久化:2400px 归零、5 MB 配额,和 64 MB 的 history.state
路由状态该存哪儿,几乎所有单页应用都会撞上同一个岔路口:history.state、sessionStorage、localStorage、URL 查询串,四条路都能走通一半,然后在某个具体场景崩掉。
为了不靠印象写这篇,我用 Playwright 1.64.1 驱动本机 Chrome 157.0.8103.40 搭了一个最小夹具:60 条订单、列表异步 800 ms 渲染、pushState 跳详情、history.back() 回列表,视口 900×700。下面每个数字都是这个夹具跑出来的,每组 3 轮。
一、回退之后,位置从 2400 掉到 0
先把列表滚到 2400px,进详情再退回来:
| 写法 | 3 轮最终 scrollY |
|---|---|
默认(scrollRestoration = 'auto') |
0 / 0 / 0 |
manual + popstate 里立刻 scrollTo |
0 / 0 / 0 |
manual + 列表渲染完成后 scrollTo |
2400 / 2400 / 2400 |
第二种最容易踩:代码写了恢复逻辑,记录恢复时刻的变量也确实被赋值(说明真的执行到了),位置还是 0。原因在 popstate 触发那一刻的文档高度——日志里是 scrollHeight: 37, maxScroll: 0。scrollTo(0, 2400) 在一个只有 37px 高的文档上会被夹成 0,之后内容渲染到 3600px,浏览器不会替你重试。
二、这不是 SPA 的问题
我原本准备把锅扣在"客户端路由"上,于是做了整页加载的对照组:同样 60 条、同样滚到 2400,用 page.goBack() 触发真实的整页回退。
- 内容随 HTML 直出:80 ms 时
scrollY已是 2400,scrollHeight3660,四次采样(80/400/1200/2200 ms)全是 2400。 - 内容改成客户端 800 ms 后渲染:80 ms 和 400 ms 采样都是 0,此时
scrollHeight为 0;1200 ms 时scrollHeight涨到 3660,scrollY依然是 0。
结论很清楚:能不能恢复,取决于浏览器执行恢复那一刻文档有多高,与走不走 SPA 无关。SPA 只是把"内容晚于文档"变成了常态,所以问题暴露得更频繁。整页加载配骨架屏加异步列表,一样归零。
三、恢复的时机是"高度稳定",不是"渲染完成"
知道原因,修法就唯一了:等高度足够再滚。但"渲染完成"这个信号不可靠——图片、字体、虚拟列表的第二批数据都会继续把文档撑高,滚到 2400 之后再被撑高,位置就偏了。
// 等文档高度稳定后再恢复滚动位置;上限 1s,避免骨架屏卡死
async function restoreScroll(target) {
if (typeof target !== 'number') return;
const deadline = performance.now() + 1000;
let last = -1, stable = 0;
while (performance.now() < deadline) {
const h = document.documentElement.scrollHeight;
const max = h - window.innerHeight;
if (max >= target && h === last) {
if (++stable >= 2) break; // 连续两帧高度不变,认为布局已稳
} else {
stable = 0;
}
last = h;
await new Promise(r => requestAnimationFrame(r));
}
const max = document.documentElement.scrollHeight - window.innerHeight;
window.scrollTo(0, Math.min(target, max));
}
history.scrollRestoration = 'manual';
addEventListener('popstate', async () => {
const target = history.state?.scroll;
await renderRoute(location); // 路由对应的异步渲染
await restoreScroll(target);
});
末尾那个 Math.min 不是保险,是必须的:target 可能来自上一次会话,窗口变窄、条目被删都会让高度缩水,不夹一下就会滚到一个不存在的坐标。
四、history.state 的语义:一份快照,不是一块存储
几条容易记错的边界,全部实测:
- 首屏
history.state是null,history.length是 2。所有"从 state 读初始筛选条件"的代码,都必须有 URL 兜底。 - 刷新保留。
pushState({tab:'orders',page:2,scroll:1840}, '', '/list?tab=orders&page=2')之后reload(),state 原样还在——它随会话历史条目一起被序列化。 - 新标签页访问同一 URL:
state为null、history.length为 2。复制链接发给同事,对方拿到的是一个没有 state 的 URL。 - 改 state 只在内存里生效。
history.state.page = 99读回来是 99,reload()之后回到 1。序列化发生在pushState那一刻,之后改的是副本。 - 不是所有东西都能放。
pushState({fn: () => 1})抛DataCloneError: Failed to execute 'pushState' on 'History': () => 1 could not be cloned.;放document.body抛同类错误,消息是HTMLBodyElement object could not be cloned.。Date和Map能过,读回来还是[object Date]和[object Map]。
体积上有个流传很久的"640 KB 上限",实测不成立:
| state 体积 | 结果 | pushState 耗时 |
|---|---|---|
| 1 MB | 成功,回读长度一致 | 8 ms |
| 16 MB | 成功 | 111 ms |
| 32 MB | 成功 | 301 ms |
| 64 MB | 成功 | 593 ms |
浏览器不拦,代价是每次导航都要复制一遍,约 7–9 ms/MB,而且这份数据同时活在会话历史里。URL 那侧同样宽松:262,144 字符的查询串 pushState 仍然成功。真正的约束不是 API 限制,是"用户点一次后退要等多久"。
所以 state 里只放路由身份和视图元信息(tab、page、scroll),控制在几百字节;列表数据放内存 store,需要跨刷新时再让 sessionStorage 兜一层。
五、sessionStorage 与 localStorage 的分界
同一夹具测出来的事实:
sessionStorage刷新后仍在(/list?page=2读得回来),新标签页读不到(null)。这正好匹配"一个标签页一条操作流"的语义。- 单 key 上限二分为 5,242,879 字符,即 5 MiB 减 1,再大抛
QuotaExceededError。额度按 UTF-16 码元计:全是中文时同样是 5,242,879 个字符,换成 emoji 只剩 2,621,439 个——一个 emoji 占两格。别指望中文能多存。 localStorage跨 origin 隔离:http://spa.test写入route,http://other.test读回null。
持久化封装必须包 try/catch,因为配额是全 origin 共享的——别的模块写满了,你的写入就会抛,而抛错的时机通常在用户点"下一页"的时候。
function saveRoute(key, payload) {
const record = { v: 1, at: Date.now(), data: payload };
try {
sessionStorage.setItem(key, JSON.stringify(record));
} catch (e) {
if (e.name === 'QuotaExceededError') {
sessionStorage.removeItem(key); // 降级:放弃持久化,不影响当前导航
}
}
}
v 字段是留给未来的自己:状态结构一改,旧记录就会以"字段缺失"的形式在新代码里炸开,有版本号才能安全丢弃。
六、每点一次筛选,后退键就多一层
夹具里连续 10 次筛选,每次 pushState:history.length 从 2 涨到 12,要按 9 次后退才能回到最初那个查询串为空的列表。
筛选、排序、分页这类同页视图变化,用 replaceState;只有真正换页面才 pushState。判断标准很简单:用户按后退,期望回到上一个页面,还是上一个筛选条件。
顺带一个必须自己记的账:popstate 事件里没有任何方向信息。实测三次前进后退,event.state 依次是 {idx:2}、{idx:1}、{idx:2},与 history.state 完全一致,事件对象上既没有"往前"也没有"往后"。要在 state 里自己维护一个递增的 idx,比较前后值才知道方向,否则"后退关闭弹窗"这类逻辑会在前进时也触发一次。
七、state 和 URL 打架时,错的是 state
最后一个坑是我自己写出来的:pushState({page: 2}, '', '/list?page=3')。当时只是想验证参数顺序,结果 history.state.page 是 2、URLSearchParams 读出来是 3,reload() 之后两者依然不一致。
这不只是笔误。它暴露了一条设计原则:URL 必须是唯一真相,state 只能是它的派生缓存。一旦代码里出现"state 说 2、URL 说 3,该听谁"的判断,就说明有地方在独立维护状态。正确写法是每次导航都由 URL 解析出路由对象,再 replaceState 回填给当前条目:
function syncStateFromUrl() {
const route = parseRoute(location); // 唯一解析入口
const scroll = history.state?.scroll ?? 0; // 只有 URL 表达不了的才留在 state
history.replaceState({ ...route, scroll }, '');
return route;
}
这样无论用户是点链接进来、刷新、还是从别处粘贴 URL,走到的都是同一份解析结果。
结论
路由状态只有一份可信来源,就是 URL;history.state 是它的附注,sessionStorage 是它的离线副本,三者职责一旦混用,症状总是以"偶发、无法复现"的形式出现。判断标准可以压成一句:这个字段刷新后还能从 URL 推出来吗——能,就别存;不能,才轮到后面两层。
- 点赞
- 收藏
- 关注作者
评论(0)