History API
一句话解释
History API 让你读取并修改浏览器会话历史栈,实现 SPA 无全量刷新导航。
用大白话说
History API 让 JavaScript 访问浏览器会话历史——用户访问过的页面栈。你可以编程方式前进后退,更关键的是,可在不触发全量页面导航的情况下向栈压入新条目。这是单页应用(SPA)路由的基础。关键方法是 pushState(带状态对象和 URL 压入新历史条目)和 replaceState(替换当前条目)。二者都改变地址栏 URL 而不重载页面。当用户点击后退/前进时,popstate 事件触发,你的代码可据此渲染对应视图。结合 fetch API,这让你构建感觉像多页站点却从不全量重载文档的应用——URL 变了、视图更新、后退按钮可用。React Router 与 Vue Router 等框架封装了此 API。
示例
javascript
// Push a new "page" without reloading
function navigateTo(path) {
history.pushState({ path }, "", path);
renderView(path); // your function to update the DOM
}
// Handle back/forward button
window.addEventListener("popstate", (e) => {
renderView(e.state?.path || "/");
});
navigateTo("/users"); // URL becomes /users, no reloadpushState 压入历史条目并改变 URL。popstate 在后退/前进时触发,让你重新渲染匹配视图。
相关术语
相关资源
相关课程
- SPA 路由
学习 SPA 导航。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。