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

瀏覽器相容性

另見