History: forward() 方法

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

forward() 方法是 History 接口的一部分,它使浏览器在会话历史记录中向前移动一页。这与调用 history.go(1) 具有相同的效果。

此方法是异步的。要确定导航何时完成,请添加一个 popstate 事件监听器。

语法

js
forward()

参数

无。

返回值

无(undefined)。

异常

SecurityError DOMException

如果关联的文档未完全激活,则会抛出此错误。浏览器还会限制导航,如果调用过于频繁,可能会抛出此错误、生成警告或忽略调用。

示例

以下示例创建了一个按钮,用于在会话历史记录中向前移动一步。

HTML

html
<button id="go-forward">Go Forward!</button>

JavaScript

js
document.getElementById("go-forward").addEventListener("click", (e) => {
  history.forward();
});

规范

规范
HTML
# dom-history-forward-dev

浏览器兼容性

另见