CKTIS / JavaScript
AbortSignal — signal za otkazivanje
AbortSignal prenosi zahtjev za otkazivanje funkciji fetch; AbortController pokreće otkazivanje, a signal izlaže njegovo stanje.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
const controller = new AbortController();
const signal = controller.signal;
fetch(url, { signal });
controller.abort(reason);AbortSignal prenosi zahtjev za otkazivanje operaciji koja ga podržava. Dohvati ga putem controller.signal iz objekta AbortController i proslijedi ga funkciji fetch kao { signal }. Otkazivanje pokreće kontroler, a ne signal.
Nakon otkazivanja, signal.aborted ima vrijednost true. Ako je obećanje koje vraća fetch još na čekanju, otkazivanjem se odbija uz razlog otkazivanja. Ako je obećanje već ispunjeno objektom Response, otkazivanje ne može uzrokovati njegovo naknadno odbijanje, ali još može prekinuti čitanje tijela odgovora. Time se ne poništavaju radnje na poslužitelju.
Primjer otkazuje prije poziva funkcije fetch, pa rezultat ne ovisi o mreži. Riječ je o Web API-ju, a ne o značajci ECMAScripta; prisutnost Nodea 24 u repozitoriju ne potvrđuje podršku u preglednicima.
Primjeri
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();Rezultat
true true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.