大网数据广告活动
Web 标准与前端开发

History API

· 52CE 我爱测

History API** 通过 Window.history 全局对象提供了对浏览器会话的历史记录(不要与 WebExtensions 的 history 混淆)的访问功能。它暴露了很多有用的方法和属性,使你可以在用户的历史记录中来回导航,而且可以操作历史记录栈中的内容。

History API

History API 通过 Window.history 全局对象提供了对浏览器会话的历史记录(不要与 WebExtensions 的 history 混淆)的访问功能。它暴露了很多有用的方法和属性,使你可以在用户的历史记录中来回导航,而且可以操作历史记录栈中的内容。

[!NOTE] 该 API 仅在主线程(Window)中可用。无法在 Worker 或 Worklet 上下文中访问它。

概念和用法

使用 History.back、History.forward 和 History.go 方法可以在用户历史记录中前后跳转。

向前和向后跳转

在历史记录中向后跳转:

history.back();

这和用户点击浏览器的回退(<kbd><strong>Back</strong></kbd>)按钮的效果相同。

类似地,你可以向前跳转(如同用户点击了前进(<kbd><strong>Forward</strong></kbd>)按钮):

history.forward();

跳转到历史记录中的指定位置

你可以用 go() 方法从会话历史记录中加载某一特定页面,该页面使用与当前页面的相对位置来标识(当前页面的相对位置为 0)。

向后跳转一个页面(等价于调用 History.back):

history.go(-1);

向前跳转一个页面,就像调用 History.forward:

history.go(1);

类似地,你可以传递参数值 2 并向前跳转 2 个页面,等等。

go() 方法的另一个用途是,在调用它时传递 0 或不传递任何参数以刷新当前页面:

// 以下语句都具有刷新页面的效果
history.go(0);
history.go();

你可以通过查看 length 属性的值来确定历史记录栈中的页面数量:

const numberOfEntries = history.length;

接口

  • History
    • : 允许操作浏览器会话的历史记录(即加载了当前页面的标签页或框架(frame)中访问过的页面)。
  • PopStateEvent
    • : Window.popstate_event 事件的接口。

示例

以下示例为 Window.popstate_event 事件分配了一个监听器。然后它演示了一些 history 对象的方法:对当前标签页浏览记录的添加、替换和跳转。

window.addEventListener("popstate", (event) => {
  alert(`位置:${document.location},状态:${JSON.stringify(event.state)}`);
});

history.pushState({ page: 1 }, "标题 1", "?page=1");
history.pushState({ page: 2 }, "标题 2", "?page=2");
history.replaceState({ page: 3 }, "标题 3", "?page=3");
history.back(); // 显示警告“位置:http://example.com/example.html?page=1,状态:{"page":1}”
history.back(); // 显示警告“位置:http://example.com/example.html,状态:null”
history.go(2); // 显示警告“位置:http://example.com/example.html?page=3,状态:{"page":3}”

规范

浏览器兼容性

参见

  • window.history 全局对象
  • Window/popstate_event 事件

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。