blob: 8c2a40bebdd60680d96cd52cc1ac4f626e17befb (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
|
---
title: History.go()
slug: Web/API/History/go
tags:
- API
- HTML DOM
- History
- 履歴 API
- メソッド
- リファレンス
browser-compat: api.History.go
translation_of: Web/API/History/go
---
{{APIRef("History API")}}
**`History.go()`** メソッドは、セッション履歴から特定のページを読み込みます。これを用いると、引数の値に応じて履歴の中を前方や後方に移動することができます。
このメソッドは{{glossary("asynchronous", "非同期")}}です。移動が完了したときを検知したい場合は {{domxref("Window/popstate_event", "popstate")}} イベントのリスナーを追加してください。
## 構文
```js
history.go([delta])
```
### 引数
- `delta` {{optional_inline}}
- : 履歴の中を移動したい先の位置で、現在のページからの相対位置です。負の数の場合は前方に移動し、正の値の場合は後方へ移動します。すなわち、例えば、 `history.go(2)` は 2 ページ後に移動し、 `history.go(-2)` は 2 ページ前に戻ります。値が渡されなかったときや、 `delta` が 0 と等しいときは、 `location.reload()` の呼び出しと同じ効果になります。
## 例
1 つページを戻す場合 ({{domxref("History.back", "back()")}} の呼び出しと同等)
```js
history.go(-1)
```
1 つページを進める場合、 {{domxref("History.forward", "forward()")}} の呼び出しと同等です。
```js
history.go(1)
```
2 つページを進める場合
```js
history.go(2);
```
2 つページを戻す場合
```js
history.go(-2);
```
そして、以下の文はいずれも現在のページを再読み込みします。
```js
history.go();
history.go(0);
```
## 仕様書
{{Specifications}}
## ブラウザーの互換性
{{Compat}}
## 関連情報
- {{domxref("History")}}
- {{DOMxRef("History.back","back()")}}
- {{DOMxRef("History.forward","forward()")}}
- {{domxref("Window/popstate_event", "popstate")}} イベント
- [履歴 API での作業](/ja/docs/Web/API/History_API/Working_with_the_History_API)
|
