Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

AbortSignal.aborted — odczyt stanu anulowania

AbortSignal.aborted to właściwość instancji tylko do odczytu. Zwraca true, gdy sygnał został anulowany, albo false w przeciwnym razie. Pozwala sprawdzić aktualny stan, ale sama nie anuluje operacji.

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

signal.aborted

AbortSignal.aborted opisuje właściwość instancji AbortSignal, odczytywaną jako signal.aborted, bez nawiasów. Zwraca wartość logiczną: false, jeśli sygnał nie został anulowany, lub true, jeśli został anulowany. Nie jest to metoda statyczna ani właściwość przeznaczona do zapisu.

Sygnał można uzyskać przez controller.signal, gdzie controller jest instancją AbortController. Wywołanie controller.abort() ustawia stan anulowania; późniejszy odczyt signal.aborted zwraca true. Anulowany sygnał nie może wrócić do stanu początkowego — do nowej, niezależnej operacji użyj nowego kontrolera.

Odczyt właściwości nie zatrzymuje pracy, nie rzuca wyjątku i nie rejestruje powiadomień. Operacja musi obsługiwać przekazany sygnał albo Twój kod musi reagować na jego stan. false nie oznacza, że operacja zakończyła się powodzeniem. Aby reagować na późniejsze anulowanie, użyj zdarzenia abort; uwzględnij też sygnał, który został anulowany jeszcze przed rejestracją nasłuchiwania.

To Web API określone w standardzie DOM, a nie funkcja konkretnej edycji ECMAScript. MDN podaje szeroką dostępność w przeglądarkach od kwietnia 2018 r., także w Web Workers. Obecność Node 24 w repozytorium nie dowodzi obsługi w przeglądarkach docelowych.

Przykłady

const controller = new AbortController();
const signal = controller.signal;

console.log(signal.aborted);
controller.abort();
console.log(signal.aborted);

Wynik

false
true

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

Źródła