Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

AbortController — anulowanie operacji fetch

AbortController przekazuje żądanie anulowania przez `signal`. `fetch` tworzy obiekt `Request`, zanim sprawdzi sygnał. Jeśli utworzenie obiektu się nie powiedzie, obietnica zostaje odrzucona z błędem tworzenia żądania (np. `TypeError` w przypadku nieprawidłowego URL), nawet jeśli sygnał został już anulowany. Jeśli `fetch` wykryje anulowanie, gdy obietnica jest jeszcze w toku, odrzuca ją z powodem anulowania. Jeśli obietnica została już spełniona obiektem `Response`, anulowanie nie zmieni jej stanu, ale może przerwać trwający odczyt treści odpowiedzi.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

const controller = new AbortController();
const signal = controller.signal;
controller.abort(reason);
fetch(input, { signal });

AbortController jest Web API, a nie elementem konkretnej edycji ECMAScript. AbortController.signal oznacza właściwość instancji controller.signal; AbortController.abort oznacza metodę instancji controller.abort(reason), nie metodę statyczną.

Przekaż signal do fetch. abort(reason) sygnalizuje anulowanie; domyślny powód to DOMException o nazwie AbortError. Sygnału nie można zresetować: nowa operacja wymagająca niezależnego anulowania potrzebuje nowego kontrolera.

Jeśli fetch pomyślnie utworzy obiekt Request i stwierdzi, że sygnał jest już anulowany, odrzuci obietnicę z powodem anulowania. Anulowanie może również przerwać odczyt treści odpowiedzi, ale nie cofa wykonanej pracy serwera. Obsługuj odrzucenie, zamiast ignorować błędy.

Przykład anuluje sygnał przed fetch, eliminując wyścig czasowy. Dostępność sprawdź w docelowej przeglądarce; Node 24 w repozytorium nie dowodzi obsługi przeglądarkowej.

Przykłady

(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);
  }
})();

Wynik

true
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła