speculation rules 中不存在 expects_no_current_entry 字段,它是对 navigation api 与 speculation rules 的错误混淆;前者是运行时 js api,后者是声明式、无状态的预加载规则,二者机制完全独立。

Speculation Rules 里没有 expects_no_current_entry 这个字段,它根本不存在于规范中。 所有声称能通过这个配置“提示浏览器导航不依赖当前条目”的说法,都是对 navigation.currentEntry 和 Speculation Rules 机制的混淆——两者完全无关。
为什么你会看到 expects_no_current_entry 这种写法
这是把 Navigation API 的概念错误嫁接到了 Speculation Rules 上。Speculation Rules 是纯声明式、无状态的预加载/预渲染规则,它只关心“什么时机(source)、对哪些 URL(urls)、做什么动作(prefetch 或 prerender)”,从不读取、也不需要知道当前 navigation.currentEntry 的值。
-
navigation.currentEntry是 Navigation API 的运行时属性,只在 JS 执行上下文中可用,比如监听navigatesuccess后读取 - Speculation Rules 在 HTML 解析阶段就被浏览器同步加载并静态应用,此时 JS 还没执行,
navigation对象甚至可能还没初始化 - 所有试图在
<script type="speculationrules"></script>里写expects_no_current_entry: true的 JSON,都会因字段非法而被整个规则块静默忽略
真正影响“是否依赖当前导航状态”的是 prerender 的触发条件
如果你实际想解决的是“预渲染页面不要受当前页面 state 或 history 状态干扰”,关键不在虚构字段,而在两点:
- 确保目标 URL 是**完整、独立、可重复访问的绝对路径**,比如
"/product/123",而不是"./detail.html?ref=current"这类带相对路径或临时参数的写法 - 避免在 prerender 目标页里做副作用操作(如读取
navigation.currentEntry.state、调用history.replaceState()、发起非幂等 POST),否则预渲染进程会在后台出错或降级为 prefetch - 若目标页必须区分入口来源,应改用 query 参数(如
?from=home)或服务端渲染逻辑,而非依赖客户端 navigation state
常见误用场景与后果
有人在 prerender 规则里硬塞一个不存在的字段,以为能“绕过 history 校验”,结果发现 prerender 没生效——其实真正原因是:
- 目标页返回了 302 重定向,而 Speculation Rules 不支持重定向链,直接放弃
- 目标页响应头缺失
Cache-Control: public,导致无法复用预渲染结果 - 页面包含
<form></form>或document.write(),浏览器主动拒绝 prerender(这是硬性限制,不是配置能改的)
Speculation Rules 的边界很清晰:它只管“提前拉资源”或“提前建页面”,不管“怎么跳”“从哪来”。想控制导航行为,请用 Navigation API;想声明预加载意图,请严格按 spec 写 JSON。混用两套机制,只会让规则失效且难以调试。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











