AbortSignal: abort() statische Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2019.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die statische Methode AbortSignal.abort() gibt ein AbortSignal zurück, das bereits auf abgebrochen gesetzt ist (und kein abort-Ereignis auslöst).

Dies ist eine Abkürzung für den folgenden Code:

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

Dies könnte beispielsweise an eine fetch-Methode übergeben werden, um deren Abbruchlogik auszuführen (das heißt, es kann sein, dass der Code so organisiert ist, dass die Abbruchlogik ausgeführt werden sollte, selbst wenn der beabsichtigte Abrufvorgang noch nicht gestartet wurde).

Hinweis: Die Methode ähnelt in ihrem Zweck Promise.reject.

Syntax

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

Parameter

reason

Der Grund, warum die Operation abgebrochen wurde, der jeder JavaScript-Wert sein kann. Wenn nicht angegeben, wird der Grund auf "AbortError" DOMException gesetzt.

Rückgabewert

Eine AbortSignal-Instanz mit der Eigenschaft AbortSignal.aborted auf true gesetzt, und AbortSignal.reason auf den angegebenen oder Standardwert des Grundes gesetzt.

Spezifikationen

Specification
DOM
# ref-for-dom-abortsignal-abort①

Browser-Kompatibilität