Skip to content

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 reload

pushState 压入历史条目并改变 URL。popstate 在后退/前进时触发,让你重新渲染匹配视图。

相关术语

相关资源

相关课程

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回术语表