Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

AutoCorrect fix files/zh-cn/web/api/{h,i,k,l}* #8789

Merged
merged 3 commits into from
Oct 2, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/headers/entries/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ slug: Web/API/Headers/entries

{{APIRef}}{{SeeCompatTable}}

**`Headers.entries()`** 以 {{jsxref("Iteration_protocols","迭代器")}} 的形式返回 Headers 对象中所有的键值对.
**`Headers.entries()`** 以 {{jsxref("Iteration_protocols","迭代器")}} 的形式返回 Headers 对象中所有的键值对

> **备注:** 这个方法在 [Web Workers](/zh-CN/docs/Web/API/Web_Workers_API)中是可用的。

Expand Down
4 changes: 2 additions & 2 deletions files/zh-cn/web/api/headers/headers/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ slug: Web/API/Headers/Headers

{{APIRef("Fetch")}}{{ SeeCompatTable() }}

`使用Headers()` 构造方法创建一个新的{{domxref("Headers")}} 对象。
使用 `Headers()` 构造方法创建一个新的 {{domxref("Headers")}} 对象。

## Syntax

Expand All @@ -16,7 +16,7 @@ var myHeaders = new Headers(init);
### Parameters

- _init_ {{optional_inline}}
- : 通过一个包含任意 [HTTP headers](/zh-CN/docs/Web/HTTP/Headers) 的对象来预设你的 `Headers`. 可以是一个{{domxref("ByteString")}} 对象; 或者是一个已存在的 `Headers` 对象.
- : 通过一个包含任意 [HTTP headers](/zh-CN/docs/Web/HTTP/Headers) 的对象来预设你的 `Headers`. 可以是一个{{domxref("ByteString")}} 对象; 或者是一个已存在的 `Headers` 对象

## Example

Expand Down
6 changes: 3 additions & 3 deletions files/zh-cn/web/api/headers/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,11 +5,11 @@ slug: Web/API/Headers

{{ APIRef("Fetch") }}

[Fetch API](/zh-CN/docs/Web/API/Fetch_API) 的 **Headers** 接口允许您对 HTTP 请求和响应头执行各种操作。 这些操作包括检索,设置,添加和删除。 一个 Headers 对象具有关联的头列表,它最初为空,由零个或多个键值对组成。你可以使用 {{domxref("Headers.append","append()")}} 方法添加 之类的方法添加到此 (参见 [示例](#示例))。在该接口的所有方法中,标题名称由不区分大小写的字节序列匹配。
[Fetch API](/zh-CN/docs/Web/API/Fetch_API) 的 **Headers** 接口允许您对 HTTP 请求和响应头执行各种操作。这些操作包括检索,设置,添加和删除。一个 Headers 对象具有关联的头列表,它最初为空,由零个或多个键值对组成。你可以使用 {{domxref("Headers.append","append()")}} 方法添加 之类的方法添加到此 (参见 [示例](#示例))。在该接口的所有方法中,标题名称由不区分大小写的字节序列匹配。

出于安全考虑,某些头只能由用户代理控制。这些头信息包括 {{Glossary("Forbidden_header_name", "forbidden header names", 1)}} 和 {{Glossary("Forbidden_response_header_name", "forbidden response header names", 1)}}。

一个 Headers 对象也有一个关联的 guard,它具有不可变的值,`request`,`request-no-cors`,`response`或`none`。 这会影响 {{domxref("Headers.set","set()")}}, {{domxref("Headers.delete","delete()")}}, 和{{domxref("Headers.append","append()")}} 方法 改变 header. 参考更多信息,请看 {{Glossary("Guard")}}.
一个 Headers 对象也有一个关联的 guard,它具有不可变的值,`request`,`request-no-cors`,`response`或`none`。这会影响 {{domxref("Headers.set","set()")}}, {{domxref("Headers.delete","delete()")}}, 和{{domxref("Headers.append","append()")}} 方法 改变 header. 参考更多信息,请看 {{Glossary("Guard")}}.

你可以通过 {{domxref("Request.headers")}} 和{{domxref("Response.headers")}} 属性检索一个`Headers`对象,并使用 {{domxref("Headers.Headers()")}} 构造函数创建一个新的`Headers` 对象。

Expand Down Expand Up @@ -43,7 +43,7 @@ slug: Web/API/Headers

> **备注:** 值得注意的是,在 header 已存在或者有多个值的状态下{{domxref("Headers.set()")}} 和 {{domxref("Headers.append()")}}的使用有如下区别,{{domxref("Headers.set()")}} 将会用新的值覆盖已存在的值,但是{{domxref("Headers.append()")}}会将新的值添加到已存在的值的队列末尾。请参相关词条内的示例代码。

> **备注:** 如果您尝试传入名称不是[有效的 HTTP 头名称](https://fetch.spec.whatwg.org/#concept-header-name)的引用,则所有 Headers 方法都将引发 `TypeError` 。 如果头部有一个不变的{{Glossary("Guard")}},则变异操作将会抛出一个 `TypeError` 。 在其他任何失败的情况下,他们默默地失败。
> **备注:** 如果您尝试传入名称不是[有效的 HTTP 头名称](https://fetch.spec.whatwg.org/#concept-header-name)的引用,则所有 Headers 方法都将引发 `TypeError` 。如果头部有一个不变的{{Glossary("Guard")}},则变异操作将会抛出一个 `TypeError` 。在其他任何失败的情况下,他们默默地失败。

### Obsolete methods

Expand Down
8 changes: 4 additions & 4 deletions files/zh-cn/web/api/history/pushstate/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,12 +16,12 @@ history.pushState(state, title[, url])
### 参数

- `state`
- : 状态对象是一个 JavaScript 对象,它与`pushState()`创建的新历史记录条目相关联。 每当用户导航到新状态时,都会触发{{event("popstate")}}事件,并且该事件的状态属性包含历史记录条目的状态对象的副本。
状态对象可以是任何可以序列化的对象。 因为 Firefox 将状态对象保存到用户的磁盘上,以便用户重新启动浏览器后可以将其还原,所以我们对状态对象的序列化表示施加了 2MiB 的大小限制。 如果将序列化表示形式大于此状态的状态对象传递给`pushState()`,则该方法将引发异常。 如果您需要更多空间,建议您使用 {{domxref("Window.sessionStorage", "sessionStorage")}}或者{{domxref("Window.localStorage", "localStorage")}}。
- : 状态对象是一个 JavaScript 对象,它与`pushState()`创建的新历史记录条目相关联。每当用户导航到新状态时,都会触发{{event("popstate")}}事件,并且该事件的状态属性包含历史记录条目的状态对象的副本。
状态对象可以是任何可以序列化的对象。因为 Firefox 将状态对象保存到用户的磁盘上,以便用户重新启动浏览器后可以将其还原,所以我们对状态对象的序列化表示施加了 2MiB 的大小限制。如果将序列化表示形式大于此状态的状态对象传递给`pushState()`,则该方法将引发异常。如果您需要更多空间,建议您使用 {{domxref("Window.sessionStorage", "sessionStorage")}}或者{{domxref("Window.localStorage", "localStorage")}}。
- `title`
- : [当前大多数浏览器都忽略此参数](https://github.com/whatwg/html/issues/2174),尽管将来可能会使用它。 在此处传递空字符串应该可以防止将来对方法的更改。 或者,您可以为要移动的状态传递简短的标题。
- : [当前大多数浏览器都忽略此参数](https://github.com/whatwg/html/issues/2174),尽管将来可能会使用它。在此处传递空字符串应该可以防止将来对方法的更改。或者,您可以为要移动的状态传递简短的标题。
- `url` {{optional_inline}}
- : 新历史记录条目的 URL 由此参数指定。 请注意,浏览器不会在调用 `pushState()` 之后尝试加载此 URL,但可能会稍后尝试加载 URL,例如在用户重新启动浏览器之后。 新的 URL 不必是绝对的。 如果是相对的,则相对于当前 URL 进行解析。 新网址必须与当前网址相同 {{glossary("origin")}}; 否则,`pushState()`将引发异常。 如果未指定此参数,则将其设置为文档的当前 URL。
- : 新历史记录条目的 URL 由此参数指定。请注意,浏览器不会在调用 `pushState()` 之后尝试加载此 URL,但可能会稍后尝试加载 URL,例如在用户重新启动浏览器之后。新的 URL 不必是绝对的。如果是相对的,则相对于当前 URL 进行解析。新网址必须与当前网址相同 {{glossary("origin")}};否则,`pushState()`将引发异常。如果未指定此参数,则将其设置为文档的当前 URL。

## 描述

Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/history/replacestate/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ slug: Web/API/History/replaceState

{{APIRef("DOM")}}

`replaceState()`方法使用`state objects`, `title`,和 `URL` 作为参数, 修改当前历史记录实体,如果你想更新当前的 state 对象或者当前历史实体的 URL 来响应用户的的动作的话这个方法将会非常有用。
`replaceState()`方法使用`state objects`, `title`,和 `URL` 作为参数,修改当前历史记录实体,如果你想更新当前的 state 对象或者当前历史实体的 URL 来响应用户的的动作的话这个方法将会非常有用。

## 语法

Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/history/state/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: state
slug: Web/API/History/state
---

返回在 history 栈顶的 `任意` 值的拷贝。 通过这种方式可以查看 state 值,不必等待 [`popstate`](/zh-CN/docs/Web/Events/popstate)事件发生后再查看。
返回在 history 栈顶的 `任意` 值的拷贝。通过这种方式可以查看 state 值,不必等待 [`popstate`](/zh-CN/docs/Web/Events/popstate)事件发生后再查看。

## 语法

Expand Down
16 changes: 8 additions & 8 deletions files/zh-cn/web/api/history_api/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ window.history.forward();

### 跳转到 history 中指定的一个点

你可以用 `go()` 方法载入到会话历史中的某一特定页面, 通过与当前页面相对位置来标志 (当前页面的相对位置标志为 0).
你可以用 `go()` 方法载入到会话历史中的某一特定页面,通过与当前页面相对位置来标志 (当前页面的相对位置标志为 0).

向后移动一个页面 (等同于调用 `back()`):

Expand Down Expand Up @@ -81,7 +81,7 @@ history.pushState(stateObj, "page 2", "bar.html");

假设现在用户在 bar.html 又访问了 `http://google.com`,然后点击了返回按钮。此时,地址栏将显示 `http://mozilla.org/bar.html`, `history.state` 中包含了 `stateObj` 的一份拷贝。页面此时展现为`bar.html`。且因为页面被重新加载了,所以 `popstate` 事件将不会被触发,也不会执行 alert(2)。

如果我们再次点击返回按钮,页面 URL 会变为 `http://mozilla.org/foo.html`,文档对象 document 会触发另外一个 `popstate` 事件 (如果有 bar.html,且 bar.html 注册了 onpopstate 事件,将会触发此事件,因此也不会执行 foo 页面注册的 onpopstate 事件,也就是不会执行 alert(2)),这一次的事件对象 state object 为 null。 这里也一样,返回并不改变文档的内容,尽管文档在接收 `popstate` 事件时可能会改变自己的内容,其内容仍与之前的展现一致。
如果我们再次点击返回按钮,页面 URL 会变为 `http://mozilla.org/foo.html`,文档对象 document 会触发另外一个 `popstate` 事件 (如果有 bar.html,且 bar.html 注册了 onpopstate 事件,将会触发此事件,因此也不会执行 foo 页面注册的 onpopstate 事件,也就是不会执行 alert(2)),这一次的事件对象 state object 为 null。这里也一样,返回并不改变文档的内容,尽管文档在接收 `popstate` 事件时可能会改变自己的内容,其内容仍与之前的展现一致。

如果我们再次点击返回按钮,页面 URL 变为其他页面的 url,依然不会执行 alert(2)。因为在返回到 foo 页面的时候并没有 pushState。

Expand All @@ -96,12 +96,12 @@ history.pushState(stateObj, "page 2", "bar.html");
- **标题** — Firefox 目前忽略这个参数,但未来可能会用到。在此处传一个空字符串应该可以安全的防范未来这个方法的更改。或者,你可以为跳转的 state 传递一个短标题。
- **URL** — 该参数定义了新的历史 URL 记录。注意,调用 `pushState()` 后浏览器并不会立即加载这个 URL,但可能会在稍后某些情况下加载这个 URL,比如在用户重新打开浏览器时。新 URL 不必须为绝对路径。如果新 URL 是相对路径,那么它将被作为相对于当前 URL 处理。新 URL 必须与当前 URL 同源,否则 `pushState()` 会抛出一个异常。该参数是可选的,缺省为当前 URL。

> **备注:** 从 Gecko 2.0 {{ geckoRelease("2.0") }} 到 Gecko 5.0 {{ geckoRelease("5.0") }},传递的对象是使用 JSON 进行序列化的。 从 Gecko 6.0 {{ geckoRelease("6.0") }}开始,该对象的序列化将使用[结构化克隆算法](/zh-CN/DOM/The_structured_clone_algorithm)。这将会使更多对象可以被安全的传递。
> **备注:** 从 Gecko 2.0 {{ geckoRelease("2.0") }} 到 Gecko 5.0 {{ geckoRelease("5.0") }},传递的对象是使用 JSON 进行序列化的。从 Gecko 6.0 {{ geckoRelease("6.0") }}开始,该对象的序列化将使用[结构化克隆算法](/zh-CN/DOM/The_structured_clone_algorithm)。这将会使更多对象可以被安全的传递。

在某种意义上,调用 `pushState()` 与 设置 `window.location = "#foo"` 类似,二者都会在当前页面创建并激活新的历史记录。但 `pushState()` 具有如下几条优点:

- 新的 URL 可以是与当前 URL 同源的任意 URL 。相反,只有在修改哈希时,设置 `window.location` 才能是同一个 {{ domxref("document") }}。
- 如果你不想改 URL,就不用改。相反,设置 `window.location = "#foo";`在当前哈希不是 `#foo` 时, 才能创建新的历史记录项。
- 新的 URL 可以是与当前 URL 同源的任意 URL。相反,只有在修改哈希时,设置 `window.location` 才能是同一个 {{ domxref("document") }}。
- 如果你不想改 URL,就不用改。相反,设置 `window.location = "#foo";`在当前哈希不是 `#foo` 时,才能创建新的历史记录项。
- 你可以将任意数据和新的历史记录项相关联。而基于哈希的方式,要把所有相关数据编码为短字符串。
- 如果 `标题` 随后还会被浏览器所用到,那么这个数据是可以被使用的(哈希则不是)。

Expand All @@ -113,11 +113,11 @@ history.pushState(stateObj, "page 2", "bar.html");

### replaceState() 方法

`history.replaceState()` 的使用与 `history.pushState()` 非常相似,区别在于 `replaceState()` 是修改了当前的历史记录项而不是新建一个。 注意这并不会阻止其在全局浏览器历史记录中创建一个新的历史记录项。
`history.replaceState()` 的使用与 `history.pushState()` 非常相似,区别在于 `replaceState()` 是修改了当前的历史记录项而不是新建一个。注意这并不会阻止其在全局浏览器历史记录中创建一个新的历史记录项。

`replaceState()` 的使用场景在于为了响应用户操作,你想要更新状态对象 state 或者当前历史记录的 URL。

> **备注:** 从 Gecko 2.0 {{ geckoRelease("2.0") }} 到 Gecko 5.0 {{ geckoRelease("5.0") }},传递的对象是使用 JSON 进行序列化的。 从 Gecko 6.0 {{ geckoRelease("6.0") }} 开始,该对象的序列化将使用[结构化克隆算法](/zh-CN/docs/Web/API/Web_Workers_API/Structured_clone_algorithm)。这将会使更多对象可以被安全的传递。
> **备注:** 从 Gecko 2.0 {{ geckoRelease("2.0") }} 到 Gecko 5.0 {{ geckoRelease("5.0") }},传递的对象是使用 JSON 进行序列化的。从 Gecko 6.0 {{ geckoRelease("6.0") }} 开始,该对象的序列化将使用[结构化克隆算法](/zh-CN/docs/Web/API/Web_Workers_API/Structured_clone_algorithm)。这将会使更多对象可以被安全的传递。

### replaceState() 方法示例

Expand Down Expand Up @@ -151,7 +151,7 @@ history.replaceState(stateObj, "page 3", "bar2.html");

页面加载时,或许会有个非 null 的状态对象。这是有可能发生的,举个例子,假如页面(通过`pushState()` 或 `replaceState()` 方法)设置了状态对象而后用户重启了浏览器。那么当页面重新加载时,页面会接收一个 onload 事件,但没有 popstate 事件。然而,假如你读取了 history.state 属性,你将会得到如同 popstate 被触发时能得到的状态对象。

你可以读取当前历史记录项的状态对象 state,而不必等待`popstate` 事件, 只需要这样使用`history.state` 属性:
你可以读取当前历史记录项的状态对象 state,而不必等待`popstate` 事件,只需要这样使用`history.state` 属性:

```js
// 尝试通过 pushState 创建历史条目,然后再刷新页面查看 state 状态对象变化;
Expand Down
Loading