KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

AbortController — fetch-bewerkingen annuleren

AbortController geeft via `signal` een annuleringsverzoek door. `fetch` maakt een `Request`-object aan voordat het het signaal controleert. Als het aanmaken mislukt, wordt de promise met die fout afgewezen (bijvoorbeeld een `TypeError` bij een ongeldige URL), ook als het signaal al geannuleerd is. Merkt `fetch` de annulering op terwijl de promise nog in behandeling is, dan wijst het die af met de annuleringsreden. Als de promise al is vervuld met een `Response`-object, verandert annulering de status ervan niet, maar kan het lezen van de response-body nog wel mislukken.

Versie: 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 is een Web-API en maakt geen deel uit van een bepaalde ECMAScript-editie. AbortController.signal verwijst naar de instantie-eigenschap controller.signal; AbortController.abort verwijst naar de instantiemethode controller.abort(reason), niet naar een statische methode.

Geef signal door aan fetch. abort(reason) geeft het signaal voor annulering; de standaardreden is een DOMException met de naam AbortError. Een signaal kan niet worden gereset: voor een nieuwe bewerking die onafhankelijk geannuleerd moet kunnen worden, is een nieuwe controller nodig.

Als fetch een Request-object kan aanmaken en vaststelt dat het signaal al geannuleerd is, wijst het de promise af met de annuleringsreden. Annulering kan ook het lezen van de response-body onderbreken, maar maakt werk van de server dat al is uitgevoerd niet ongedaan. Handel de afwijzing af in plaats van fouten te negeren.

Het voorbeeld annuleert vóór fetch en voorkomt zo timing-races. Controleer de beschikbaarheid in de doelbrowser; Node 24 in de repository bewijst geen browserondersteuning.

Voorbeelden

(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);
  }
})();

Resultaat

true
true

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen