Skip to content

Commit

Permalink
[zh-cn]: update the translation of History forward() method (#24839)
Browse files Browse the repository at this point in the history
  • Loading branch information
T34-active authored Dec 1, 2024
1 parent 70edaa5 commit d0b0b5f
Showing 1 changed file with 32 additions and 11 deletions.
43 changes: 32 additions & 11 deletions files/zh-cn/web/api/history/forward/index.md
Original file line number Diff line number Diff line change
@@ -1,36 +1,51 @@
---
title: forward()
title: History:forward() 方法
slug: Web/API/History/forward
l10n:
sourceCommit: fa980709ec5dd768d46b50b8c4833cc2f8346e21
---

{{APIRef("History API")}}

在会话历史中向前移动一页。它与使用`delta`参数为 1 时调用 `history.go(delta)`的效果相同。
{{domxref("History")}} 接口的 **`forward()`** 方法使浏览器在会话历史中向前移动一页。它的调用效果与 {{domxref("History.go", "history.go(1)")}} 相同。

此方法是{{glossary("asynchronous", "异步")}}的。请添加一个监听器来监听 {{domxref("Window/popstate_event", "popstate")}} 事件,以便确定导航何时完成。

## 语法

```js
window.history.forward();
```js-nolint
forward()
```

### 参数

无。

### 返回值

无({{jsxref("undefined")}})。

### 异常

- `SecurityError` {{domxref("DOMException")}}
- : 如果关联的文档未完全激活,则会抛出此异常。浏览器还会限制导航操作,如果调用过于频繁,可能会抛出此错误、生成警告或忽略该调用。

## 示例

下述例子创建了一个按钮,该按钮会在会话历史中向前移动一步
以下示例创建了一个在会话历史中向前移动一步的按钮

### HTML

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

### JavaScript

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

## 规范
Expand All @@ -40,3 +55,9 @@ window.onload = function (e) {
## 浏览器兼容性

{{Compat}}

## 参见

- {{domxref("History")}}
- {{domxref("Window/popstate_event", "popstate")}}
- [使用历史记录 API](/zh-CN/docs/Web/API/History_API/Working_with_the_History_API)

0 comments on commit d0b0b5f

Please sign in to comment.