From 966f3be9dfc0f95c9a6ec6df4dcde195d012e4ba Mon Sep 17 00:00:00 2001 From: 李轻舟 <30641714+lqzo@users.noreply.github.com> Date: Thu, 16 Dec 2021 09:41:56 +0800 Subject: Improve Web/API/AbortController, zh-CN (#3335) --- files/zh-cn/web/api/abortcontroller/index.html | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/files/zh-cn/web/api/abortcontroller/index.html b/files/zh-cn/web/api/abortcontroller/index.html index c29b4a0a7d..98e161364b 100644 --- a/files/zh-cn/web/api/abortcontroller/index.html +++ b/files/zh-cn/web/api/abortcontroller/index.html @@ -11,38 +11,38 @@ original_slug: Web/API/FetchController ---
{{APIRef("DOM")}}{{SeeCompatTable}}
-

AbortController接口表示一个控制器对象，允许你根据需要中止一个或多个 Web请求。

+

AbortController 接口表示一个控制器对象，允许你根据需要中止一个或多个 Web 请求。

-

你可以使用 {{domxref("AbortController.AbortController()")}} 构造函数创建一个新的 AbortController 。使用{{domxref("AbortSignal")}} 对象可以完成与与DOM请求的通信。

+

你可以使用 {{domxref("AbortController.AbortController()")}} 构造函数创建一个新的 AbortController。使用 {{domxref("AbortSignal")}} 对象可以完成与 DOM 请求的通信。

构造函数

{{domxref("AbortController.AbortController()")}}
-
创建一个新的AbortController 对象实例。
+
创建一个新的 AbortController 对象实例。

属性

{{domxref("AbortController.signal")}} {{readonlyInline}}
-
返回一个{{domxref("AbortSignal")}}对象实例，它可以用来 with/abort 一个Web(网络)请求。
+
返回一个 {{domxref("AbortSignal")}} 对象实例，它可以用来 with/abort 一个 Web(网络)请求。

方法

{{domxref("AbortController.abort()")}}
-
中止一个尚未完成的Web(网络)请求。这能够中止fetch 请求，任何响应{{domxref("Body")}}的消费者和流。
+
中止一个尚未完成的 Web(网络)请求。这能够中止 fetch 请求及任何响应体的消费和流。

示例

-

在下面的代码片段中，我们想通过 Fetch API 下载一段视频。

+

在下面的代码片段中，我们想通过 Fetch API 下载一段视频。

-

我们先使用{{domxref("AbortController.AbortController","AbortController()")}}构造函数创建一个控制器，然后使用{{domxref("AbortController.signal")}}属性获取其关联 {{domxref("AbortSignal")}}对象的引用。

+

我们先使用 {{domxref("AbortController.AbortController","AbortController()")}} 构造函数创建一个控制器，然后使用 {{domxref("AbortController.signal")}} 属性获取其关联 {{domxref("AbortSignal")}} 对象的引用。

-

当一个 fetch request 初始化，我们把 AbortSignal 作为一个选项传递到到请求对象（如下 {signal}）。这将信号和控制器与获取请求相关联然后允许我们通过调用{{domxref("AbortController.abort()")}}中止请求，如下第二个事件监听函数。

+

当一个 fetch request 初始化，我们把 AbortSignal 作为一个选项传递到到请求对象（如下 { signal }）。这将 signal 和 controller 与这个 fetch request 相关联，然后允许我们通过调用 {{domxref("AbortController.abort()")}} 中止请求，如下第二个事件监听函数。

const controller = new AbortController();
 let signal = controller.signal;
@@ -67,10 +67,10 @@ function fetchVideo() {
 }
-

注意：当abort() 被调用时，fetch() promise 拒绝一个名为 AbortError 的DOMException 。

+

注意：当 abort() 被调用时，这个 fetch() promise 将 reject 一个名为 AbortError 的 DOMException。

-

可以在GitHub上找到完整的工作示例 — 请参见 abort-api（另请参见实时运行）。

+

您可以在 GitHub 上找到这个示例的完整源代码(也可以在线运行)。

规范

-- cgit v1.2.3-54-g00ecf