History: go() メソッド

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

History.go() メソッドは、セッション履歴から特定のページを読み込みます。これを用いると、引数の値に応じて履歴の中を前方や後方に移動することができます。

このメソッドは非同期です。移動が完了したときを検知したい場合は popstate イベントのリスナーを追加してください。

構文

js
go()
go(delta)

引数

delta 省略可

履歴の中を移動したい先の位置で、現在のページからの相対位置です。負の数の場合は前方に移動し、正の値の場合は後方へ移動します。すなわち、例えば、 history.go(2) は 2 ページ後に移動し、 history.go(-2) は 2 ページ前に戻ります。値が渡されなかったときや、 delta が 0 と等しいときは、 location.reload() の呼び出しと同じ効果になります。

返値

なし (undefined)。

1 つページを戻す場合 (back() の呼び出しと同等)

js
history.go(-1);

1 つページを進める場合、 forward() の呼び出しと同等です。

js
history.go(1);

2 つページを進める場合

js
history.go(2);

2 つページを戻す場合

js
history.go(-2);

そして、以下の文はいずれも現在のページを再読み込みします。

js
history.go();
history.go(0);

仕様書

Specification
HTML Standard
# dom-history-go-dev

ブラウザーの互換性

BCD tables only load in the browser

関連情報