CKTIS / JavaScript
AbortController – rušení operací fetch
AbortController předává požadavek na zrušení prostřednictvím `signal`. Funkce `fetch` vytvoří objekt `Request`, než zkontroluje signál. Pokud se vytvoření objektu nezdaří, promise se zamítne s příslušnou chybou (například `TypeError` u neplatné URL), i když už je signál zrušený. Pokud `fetch` zjistí zrušení, dokud její promise stále čeká na výsledek, zamítne ji s důvodem zrušení. Pokud už byla promise splněna objektem `Response`, zrušení její stav nezmění, ale může přerušit probíhající čtení těla odpovědi.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
const controller = new AbortController();
const signal = controller.signal;
controller.abort(reason);
fetch(input, { signal });AbortController je Web API, nikoli součást konkrétní edice ECMAScriptu. AbortController.signal označuje vlastnost instance controller.signal; AbortController.abort označuje metodu instance controller.abort(reason), nikoli statickou metodu.
Předej signal funkci fetch. abort(reason) signalizuje zrušení; výchozím důvodem je DOMException s názvem AbortError. Signál nelze resetovat: nová operace, kterou je třeba rušit nezávisle, vyžaduje nový řadič.
Pokud fetch úspěšně vytvoří objekt Request a zjistí, že signál je už zrušený, zamítne promise s důvodem zrušení. Zrušení může také přerušit čtení těla odpovědi, ale nevrátí zpět práci, kterou už provedl server. Zamítnutí zpracuj a chyby neignoruj.
Příklad ruší operaci ještě před voláním fetch, takže se vyhne časovým závodům. Dostupnost ověř v cílovém prohlížeči; Node 24 v repozitáři nedokládá podporu v prohlížečích.
Pří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ýsledek
true true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.