CKTIS / JavaScript
AbortController – rušenie operácií fetch
AbortController odovzdáva požiadavku na zrušenie prostredníctvom `signal`. Funkcia `fetch` vytvorí objekt `Request` ešte pred kontrolou signálu. Ak sa vytvorenie objektu nepodarí, promise sa zamietne s príslušnou chybou (napríklad `TypeError` pri neplatnej URL), aj keď je signál už zrušený. Ak `fetch` zistí zrušenie, kým jej promise ešte čaká na výsledok, zamietne ju s dôvodom zrušenia. Ak už bola promise splnená objektom `Response`, zrušenie jej stav nezmení, ale môže prerušiť prebiehajúce čítanie tela odpovede.
Verzia: 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 je Web API, nie súčasť konkrétnej edície ECMAScriptu. AbortController.signal označuje vlastnosť inštancie controller.signal; AbortController.abort označuje metódu inštancie controller.abort(reason), nie statickú metódu.
Odovzdaj signal funkcii fetch. abort(reason) signalizuje zrušenie; predvoleným dôvodom je DOMException s názvom AbortError. Signál sa nedá resetovať: nová operácia, ktorú treba zrušiť nezávisle, potrebuje nový ovládač.
Ak fetch úspešne vytvorí objekt Request a zistí, že signál je už zrušený, zamietne promise s dôvodom zrušenia. Zrušenie môže prerušiť aj čítanie tela odpovede, ale nevráti späť prácu, ktorú už vykonal server. Zamietnutie spracuj a chyby neignoruj.
Príklad ruší operáciu ešte pred volaním fetch, čím sa vyhne časovým pretekom. Dostupnosť over v cieľovom prehliadači; Node 24 v repozitári nedokazuje podporu v prehliadačoch.
Príklady
(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);
}
})();Výsledok
true true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.