CKTIS / JavaScript
AbortSignal — sygnał anulowania
AbortSignal przekazuje żądanie anulowania do fetch; AbortController inicjuje anulowanie, a sygnał udostępnia jego stan.
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;
fetch(url, { signal });
controller.abort(reason);AbortSignal przekazuje żądanie anulowania do obsługującej go operacji. Pobierz go przez controller.signal z AbortController i przekaż jako { signal } do fetch. Anulowanie inicjuje kontroler, nie sygnał.
Po anulowaniu signal.aborted ma wartość true. Jeśli obietnica zwrócona przez fetch jest jeszcze w stanie oczekiwania, anulowanie powoduje jej odrzucenie z powodem anulowania. Jeśli obietnica została już spełniona obiektem Response, anulowanie nie może jej odrzucić, ale wciąż może przerwać odczyt treści odpowiedzi. Nie cofa to działań serwera.
Przykład anuluje sygnał przed wywołaniem fetch, więc wynik nie zależy od sieci. To Web API, nie funkcja ECMAScript; obecność Node 24 w repozytorium nie potwierdza obsługi w przeglądarce.
Przykłady
async function main() {
const controller = new AbortController();
const signal = controller.signal;
const reason = new Error("Stopped");
controller.abort(reason);
try {
await fetch("data:text/plain,hello", { signal });
} catch (error) {
console.log(signal.aborted);
console.log(error === reason);
}
}
main();Wynik
true true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.