WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

AbortSignal.aborted — Abbruchstatus auslesen

AbortSignal.aborted ist eine schreibgeschützte Instanzeigenschaft. Sie gibt true zurück, wenn das Signal abgebrochen wurde, andernfalls false. Damit lässt sich der aktuelle Status prüfen; die Eigenschaft bricht eine Operation jedoch nicht selbst ab.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

signal.aborted

AbortSignal.aborted bezeichnet eine Instanzeigenschaft von AbortSignal, die als signal.aborted und ohne Klammern gelesen wird. Sie gibt einen booleschen Wert zurück: false, wenn das Signal nicht abgebrochen wurde, oder true, wenn es abgebrochen wurde. Sie ist weder eine statische Methode noch eine beschreibbare Eigenschaft.

Ein Signal erhältst du über controller.signal, wobei controller eine Instanz von AbortController ist. Der Aufruf von controller.abort() setzt den Abbruchstatus; ein anschließendes Auslesen von signal.aborted gibt true zurück. Ein abgebrochenes Signal kann nicht in seinen Ausgangszustand zurückkehren – verwende für eine neue, unabhängige Operation einen neuen Controller.

Das Auslesen der Eigenschaft beendet keine Arbeit, löst keine Ausnahme aus und registriert keine Benachrichtigungen. Eine Operation muss das übergebene Signal unterstützen, oder dein Code muss auf seinen Status reagieren. false bedeutet nicht, dass die Operation erfolgreich war. Um auf einen späteren Abbruch zu reagieren, verwende das abort-Ereignis; berücksichtige auch den Fall, dass das Signal bereits vor dem Registrieren des Listeners abgebrochen wurde.

Dies ist eine durch den DOM-Standard definierte Web-API und kein Merkmal einer bestimmten ECMAScript-Ausgabe. MDN gibt an, dass sie seit April 2018 in den meisten Browsern verfügbar ist, auch in Web Workers. Dass Node 24 in einem Repository vorhanden ist, belegt nicht die Unterstützung in den Zielbrowsern.

Beispiele

const controller = new AbortController();
const signal = controller.signal;

console.log(signal.aborted);
controller.abort();
console.log(signal.aborted);

Ergebnis

false
true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen