AbortSignal: abort() 静态方法

注意:此功能在 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①

浏览器兼容性

BCD 表格仅在浏览器中加载