CKTIS / JavaScript
clearTimeout — anulowanie timera
clearTimeout(id) anuluje oczekujące wywołanie zaplanowane przez setTimeout(). Aby je anulować, podaj identyfikator timera, a nie funkcję przekazaną jako callback. Argument jest opcjonalny: wywołanie clearTimeout() bez argumentu używa domyślnej wartości 0 i niczego nie anuluje.
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
clearTimeout()
clearTimeout(id)clearTimeout(id) anuluje timer wskazany przez identyfikator zwrócony przez setTimeout(). Zwraca undefined. Jest API standardu HTML dostępnym w oknach przeglądarki i workerach, a nie częścią samego ECMAScript. Standard wskazuje obsługę we wszystkich obecnych silnikach przeglądarek; obecność Node 24 nie potwierdza obsługi API przeglądarkowych.
Zachowaj identyfikator i anuluj timer w tym samym środowisku globalnym, w którym został utworzony. Identyfikator nieobecny w rejestrze timerów niczego nie zmienia. Anulowanie nie przerywa już wykonywanego callbacku ani nie cofa jego skutków.
clearTimeout() i clearInterval() korzystają ze wspólnego rejestru, więc technicznie mogą anulować oba rodzaje timerów. Dla czytelności łącz setTimeout() z clearTimeout(), a setInterval() z clearInterval().
W przykładzie anulowanie następuje synchronicznie, zanim callback może się wykonać. Opóźnienie 0 nie oznacza natychmiastowego wykonania, dlatego jedynym wypisanym komunikatem jest cancelled.
Przykłady
(() => {
const id = setTimeout(() => console.log("unexpected"), 0);
clearTimeout(id);
console.log("cancelled");
})();Wynik
cancelled
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.