Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje