CKTIS / JavaScript
AbortController – preklic operacij fetch
AbortController prek `signal` posreduje zahtevo za preklic. Funkcija `fetch` ustvari objekt `Request`, preden preveri signal. Če ustvarjanje objekta ne uspe, se obljuba zavrne z ustrezno napako (na primer `TypeError` pri neveljavnem URL-ju), tudi če je signal že preklican. Če `fetch` zazna preklic, ko je obljuba še v stanju čakanja, jo zavrne z razlogom za preklic. Če je bila obljuba že izpolnjena z objektom `Response`, preklic ne spremeni njenega stanja, lahko pa prekine branje telesa odgovora, če to še poteka.
Različica: 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 spletni API in ni del določene izdaje ECMAScript. AbortController.signal označuje lastnost primerka controller.signal; AbortController.abort označuje metodo primerka controller.abort(reason), ne statične metode.
Funkciji fetch posreduj signal. abort(reason) signalizira preklic; privzeti razlog je DOMException z imenom AbortError. Signala ni mogoče ponastaviti: za novo operacijo, ki jo je treba preklicati neodvisno, potrebuješ nov krmilnik.
Če fetch uspešno ustvari objekt Request in ugotovi, da je signal že preklican, zavrne obljubo z razlogom za preklic. Preklic lahko prekine tudi branje telesa odgovora, ne razveljavi pa dela, ki ga je strežnik že opravil. Obravnavaj zavrnitev, namesto da prezreš napake.
Primer prekliče operacijo pred klicem fetch, zato se izogne časovnim tekmovanjem. Razpoložljivost preveri v ciljnem brskalniku; Node 24 v repozitoriju ne dokazuje podpore v brskalnikih.
Primeri
(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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.