WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

AbortController – fetch-Operationen abbrechen

AbortController übermittelt eine Abbruchanforderung über `signal`. `fetch` erzeugt ein `Request`-Objekt, bevor es das Signal prüft. Schlägt das Erzeugen fehl, wird das Promise mit diesem Fehler zurückgewiesen (etwa mit einem `TypeError` bei einer ungültigen URL), auch wenn das Signal bereits abgebrochen ist. Erkennt `fetch` den Abbruch, solange das Promise noch aussteht, weist es das Promise mit dem Abbruchgrund zurück. Wurde das Promise bereits mit einem `Response`-Objekt erfüllt, ändert der Abbruch seinen Zustand nicht mehr, kann aber das laufende Lesen des Antwortinhalts unterbrechen.

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

const controller = new AbortController();
const signal = controller.signal;
controller.abort(reason);
fetch(input, { signal });

AbortController ist eine Web-API und gehört nicht zu einer bestimmten ECMAScript-Version. AbortController.signal bezeichnet die Instanzeigenschaft controller.signal; AbortController.abort bezeichnet die Instanzmethode controller.abort(reason), nicht eine statische Methode.

Übergib signal an fetch. abort(reason) signalisiert den Abbruch; der Standardgrund ist eine DOMException mit dem Namen AbortError. Ein Signal kann nicht zurückgesetzt werden: Für einen neuen Vorgang, der unabhängig abgebrochen werden können muss, ist ein neuer Controller erforderlich.

Wenn fetch ein Request-Objekt erfolgreich erzeugt und feststellt, dass das Signal bereits abgebrochen ist, weist es das Promise mit dem Abbruchgrund zurück. Ein Abbruch kann auch das Lesen des Antwortinhalts unterbrechen, macht aber bereits geleistete Serverarbeit nicht rückgängig. Behandle die Zurückweisung, statt Fehler zu ignorieren.

Das Beispiel bricht vor fetch ab und vermeidet so Timing-Rennen. Prüfe die Verfügbarkeit im Zielbrowser; Node 24 im Repository belegt keine Browserunterstützung.

Beispiele

(async () => {
  const controller = new AbortController();
  const reason = new Error("Cancelled");
  controller.abort(reason);

  try {
    await fetch("data:text/plain,hello", {
      signal: controller.signal
    });
    console.log("unexpected success");
  } catch (error) {
    console.log(controller.signal.aborted);
    console.log(error === reason);
  }
})();

Ergebnis

true
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