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.