CKTIS / JavaScript
clearInterval — anulowanie timera cyklicznego
clearInterval(id) anuluje timer wskazany przez identyfikator zwrócony przez setInterval(). Zatrzymuje kolejne wywołania, ale nie przerywa trwającej funkcji.
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
clearInterval(id)clearInterval(id) usuwa timer cykliczny. Zachowaj liczbowy identyfikator zwrócony przez setInterval() i przekaż go w tym samym globalnym środowisku. Jest to Web API standardu HTML, dostępne w oknach i workerach, a nie funkcja zdefiniowana przez ECMAScript. Standard wskazuje obsługę we wszystkich obecnych silnikach przeglądarek.
Anulowanie zapobiega kolejnym wywołaniom, lecz nie przerywa aktualnie wykonywanej funkcji ani nie cofa jej skutków. Nieistniejący identyfikator niczego nie zmienia; ponowne anulowanie bez ponownego użycia tego identyfikatora jest nieszkodliwe. Wynikiem wywołania jest undefined.
clearInterval() i clearTimeout() korzystają ze wspólnej mapy identyfikatorów, więc mogą anulować oba rodzaje timerów. Dla czytelności łącz jednak setInterval() z clearInterval(). Identyfikatory należą do konkretnego globalnego środowiska, a nie do wszystkich okien i workerów.
Przykład anuluje timer wewnątrz trzeciego wywołania. Kod po clearInterval(id) nadal wypisuje stopped. Opóźnienie 20 nie gwarantuje dokładnego odstępu czasowego; sprawdzaj kolejność wyników, nie czas ich pojawienia się.
Przykłady
(() => {
let count = 0;
const id = setInterval(() => {
count += 1;
console.log(count);
if (count === 3) {
clearInterval(id);
console.log("stopped");
}
}, 20);
})();Wynik
1 2 3 stopped
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.