Navigation API 达到 Baseline:History API 的设计缺陷,终于有了一个“从头设计”的替代品
Navigation API 在 2026 年 1 月达到 Baseline Newly Available,Chrome、Edge、Firefox 147 和 Safari 26.2 均已支持。它的定位不是“History API 的增量补丁”,而是“从头设计、旨在完全取代 History API”的替代方案。
History API 的缺陷是结构性的,不是实现 bug。它无法检测所有类型的导航触发;无法读取完整的历史记录堆栈,也无法编辑非当前条目;popstate 事件在通过代码调用 pushState 或 replaceState 时不会触发,行为不一致。前 HTML 规范编写者 Ian Hickson 曾把 pushState() 称为他“最喜欢的错误”。这些缺陷导致 SPA 的路由代码长期依赖碎片化的变通:为链接绑定点击监听器、单独处理 popstate、手动处理滚动恢复和焦点管理。
Navigation API 的核心是 navigate 事件:任何类型的导航——点击链接、提交表单、后退/前进、编程调用——都会触发它,取代了碎片化的监听器组合。event.intercept() 自动处理 URL 更新、历史记录堆栈管理和焦点管理等可访问性原语,省去大量冗余代码。它还提供内置的滚动恢复、用于取消导航的中止信号,以及用于集中错误处理的 navigateSuccess / navigateError 事件。历史记录管理也改进了:navigation.entries() 可以查看完整的同源历史条目列表,.getState() 访问任意条目的结构化状态,traverseTo(key) 直接跳转到特定条目。
一个需要提前知道的实现差异是 Safari。Navigation API 将导航拦截分为两部分:precommitHandler 在 URL 更改前执行任务(比如在旧内容仍然可见时获取数据),postcommitHandler 在 URL 更新后切换内容。Safari 目前的实现尚不支持 precommitHandler。这意味着如果你的路由逻辑依赖“在 URL 变化之前完成数据预取”,在 Safari 上需要有一个降级路径,或者接受“URL 先变、内容后到”的时序差异。
对正在写 SPA 路由的团队来说,一个务实的迁移判断是:如果你在维护一个自研路由,或者大量使用 History API 的底层事件,Navigation API 的 navigate 事件和 intercept 能显著减少边界情况的处理代码;如果你在用成熟的路由库(React Router、Vue Router、SvelteKit 等),迁移的收益取决于库本身是否已经基于 Navigation API 重写,而不是直接操作 API。但即使不直接使用,理解“导航是一个可以被统一拦截的事件,而不是一组需要手动拼接的监听器”这个模型,对于设计路由的可访问性和滚动恢复仍然有价值。
- 点赞
- 收藏
- 关注作者
评论(0)