SuperAPI AI 工具集

browser-page-lifecycle-bfcache-contracts

通用与其它

查看项目

更新于 10-16 06:44

技能介绍

用途:当浏览器前进/后退恢复的是内存中完整文档而非重新运行启动逻辑时,页面可能显示过期的用户可见状态或半存活资源。本技能用于识别并修正这类恢复问题,而非简单禁用缓存。

主要能力与用法: 使用真实同标签页历史穿梭复现,记录 pageshow 事件与 event.persisted,不凭“后退很快”推断 bfcache。区分“可缓存资格”与“恢复正确性”:页面可被缓存却恢复出过期状态,也可能出于合理原因不可缓存,应先用浏览器诊断再考虑响应头或移除事件。 当 persisted === true 时,只重校验页面冻结期间可能变化的易变状态:登录可见性、权限、购物车与账户数据、连接状态、时间敏感 UI。保持恢复路径幂等,避免重复添加监听器、观察器、定时器、socket 或埋点。 在合适的生命周期信号释放或暂停资源,恢复时按 API 要求重新打开。不要用 unload 作为可靠的收尾钩子,移动端终止可能跳过它且会影响 bfcache。仅在存在真正未保存数据需确认时注册 beforeunload,脏状态清除后移除。 不要默认在每次 persisted 的 pageshow 上 location.reload(),盲重载可能丢弃草稿、重复不安全导航、重复埋点,或掩盖缺失的恢复契约;除非“全新加载”是产品明确的安全契约,否则优先做定向校验。 建议补充浏览器回归测试:加载并改动状态(或从第二个上下文修改),导航离开后再返回,确认是否发生持久化恢复,并断言恢复后的状态与资源数量。

快速探测:监听一次 pageshow 并打印 persisted、当前认证/数据版本、活动连接与监听器数量;用 DevTools 运行 bfcache 资格测试记录阻塞原因;执行 A→B→后退两次,第二次重复回调常暴露非幂等的恢复接线;在另一标签页改登出/账户/购物车状态后返回,断言未暴露私有或过期状态。

边界:初次冷启动的 URL 到屏幕重建由 deeplink-hydration 负责;Service Worker 与 Cache Storage 字节由 pwa-offline-cache-contracts 负责;重连、续传游标、心跳与事件顺序由 realtime-transport-contracts 负责;本技能只关注恢复是否恰好触发一次资源重开。

限制与门槛:需有真实历史穿梭及持久化恢复或具体资格阻塞证据,并关联到用户可见的过期/私有状态、重复或失效资源、工作丢失或可测量的导航回归。拒绝弱发现:仅有 pageshow/pagehide/unload/缓存头或快速后退;已幂等的清理;无恢复序列的假设性过期断言。不要仅为消除 bfcache 诊断就提议 no-store 或无条件 reload。输出先给结论(confirmed、candidate/needs evidence、reject 或 route),报告导航序列、浏览器、持久化/资格证据、出错状态或资源、技能边界、最小修正与回归;缺少持久化或资格证据时应标为证据缺口而非确认缺陷。