AbortSignal: abort() 静态方法

Baseline 已广泛支持

此功能已成熟,并可在多种设备和浏览器版本上运行。自 2021 年 9 月起,所有浏览器均已支持此功能。

注意:此功能在 Web Workers 中可用。

AbortSignal.abort() 静态方法返回一个已设置为已中止的 AbortSignal(并且不会触发 abort 事件)。

这是以下代码的简写:

js
const controller = new AbortController();
controller.abort();
return controller.signal;

例如,这可以传递给 fetch 方法以运行其中止逻辑(也就是说,即使预期中的 fetch 操作尚未开始,代码也可能组织成需要运行中止逻辑)。

注意: 该方法的作用与 Promise.reject 类似。

语法

js
AbortSignal.abort()
AbortSignal.abort(reason)

参数

reason

操作被中止的原因,可以是任何 JavaScript 值。如果未指定,原因将设置为 "AbortError" DOMException

返回值

一个 AbortSignal 实例,其中 AbortSignal.aborted 属性设置为 true,并且 AbortSignal.reason 设置为指定或默认的原因值。

规范

规范
DOM
# ref-for-dom-abortsignal-abort①

浏览器兼容性