CKTIS / JavaScript
AbortController — otkazivanje operacija fetch
AbortController prenosi zahtjev za otkazivanje putem signala `signal`. Funkcija `fetch` stvara objekt `Request` prije provjere signala. Ako stvaranje objekta ne uspije, promise se odbija s odgovarajućom pogreškom (primjerice `TypeError` zbog nevaljanog URL-a), čak i ako je signal već otkazan. Ako `fetch` otkrije otkazivanje dok je promise još na čekanju, odbija ga s razlogom otkazivanja. Ako je promise već ispunjen objektom `Response`, otkazivanje ne mijenja njegovo stanje, ali može prekinuti čitanje tijela odgovora ako je ono još u tijeku.
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;
controller.abort(reason);
fetch(input, { signal });AbortController je Web API, a ne dio određenog izdanja ECMAScripta. AbortController.signal označava svojstvo instance controller.signal; AbortController.abort označava metodu instance controller.abort(reason), a ne statičku metodu.
Proslijedi signal funkciji fetch. abort(reason) signalizira otkazivanje; zadani je razlog DOMException nazvan AbortError. Signal se ne može resetirati: za novu operaciju koju treba otkazati neovisno potreban je novi kontroler.
Ako fetch uspješno stvori objekt Request i utvrdi da je signal već otkazan, odbija promise s razlogom otkazivanja. Otkazivanje može prekinuti i čitanje tijela odgovora, ali ne poništava rad koji je poslužitelj već obavio. Obradi odbijanje umjesto da zanemaruješ pogreške.
Primjer otkazuje operaciju prije poziva fetch i tako uklanja vremenske utrke. Dostupnost provjeri u ciljnom pregledniku; Node 24 u repozitoriju ne dokazuje podršku u preglednicima.
Primjeri
(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);
}
})();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.