History: go() メソッド
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。
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);
仕様書
| 仕様書 |
|---|
| HTML # dom-history-go-dev |