CKTIS / JavaScript
AbortSignal — annuleringssignaal
AbortSignal geeft een annuleringsverzoek door aan fetch; AbortController start de annulering, terwijl het signaal de status ervan beschikbaar maakt.
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;
fetch(url, { signal });
controller.abort(reason);AbortSignal geeft een annuleringsverzoek door aan een bewerking die dit ondersteunt. Haal het op via controller.signal van een AbortController en geef het als { signal } door aan fetch. De controller start de annulering, niet het signaal.
Na annulering is signal.aborted gelijk aan true. Als de door fetch geretourneerde Promise nog in behandeling is, wordt deze bij annulering afgewezen met de annuleringsreden. Als de Promise al met een Response is vervuld, kan annulering niet alsnog tot afwijzing leiden, maar het lezen van de responsebody kan nog wel worden onderbroken. Hiermee worden acties op de server niet ongedaan gemaakt.
Het voorbeeld annuleert voordat fetch wordt aangeroepen, zodat het resultaat niet afhankelijk is van het netwerk. Dit is een Web API, geen ECMAScript-functie; de aanwezigheid van Node 24 in de repository bewijst geen browserondersteuning.
Voorbeelden
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();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.