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①

瀏覽器相容性