WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

AbortSignal — Abbruchsignal

AbortSignal übermittelt eine Abbruchanforderung an fetch; AbortController leitet den Abbruch ein, während das Signal dessen Status bereitstellt.

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;
fetch(url, { signal });
controller.abort(reason);

AbortSignal übermittelt eine Abbruchanforderung an eine unterstützende Operation. Rufe es über controller.signal von einem AbortController ab und übergib es als { signal } an fetch. Der Controller leitet den Abbruch ein, nicht das Signal.

Nach dem Abbruch ist signal.aborted gleich true. Ist das von fetch zurückgegebene Promise noch ausstehend, wird es beim Abbruch mit dem Abbruchgrund zurückgewiesen. Wurde das Promise bereits mit einem Response-Objekt erfüllt, kann der Abbruch es nicht nachträglich zurückweisen, aber das Lesen des Antwortkörpers noch unterbrechen. Dadurch werden keine Aktionen auf dem Server rückgängig gemacht.

Das Beispiel bricht vor dem Aufruf von fetch ab, sodass das Ergebnis nicht vom Netzwerk abhängt. Dies ist eine Web API, kein ECMAScript-Feature; Node 24 im Repository belegt keine Browserunterstützung.

Beispiele

async function main() {
  const controller = new AbortController();
  const signal = controller.signal;
  const reason = new Error("Stopped");

  controller.abort(reason);

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

main();

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