CKTIS / JavaScript
clearTimeout — zrušení časovače
clearTimeout(id) zruší čekající volání naplánované pomocí setTimeout(). Chcete-li je zrušit, předejte identifikátor příslušného časovače, nikoli funkci předanou jako callback. Argument je nepovinný: při volání clearTimeout() bez argumentu se použije výchozí hodnota 0 a nic se nezruší.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
clearTimeout()
clearTimeout(id)clearTimeout(id) zruší časovač určený hodnotou vrácenou funkcí setTimeout(). Vrací undefined. Jde o API standardu HTML dostupné v oknech prohlížeče a workerech, nikoli o součást samotného ECMAScriptu. Standard uvádí podporu ve všech současných jádrech prohlížečů; přítomnost Node 24 nepotvrzuje podporu API prohlížeče.
Uložte si identifikátor a časovač zrušte ve stejném globálním prostředí, ve kterém byl vytvořen. Identifikátor, který není v registru časovačů, nic nezmění. Zrušení nepřeruší callback, který se už vykonává, ani nevrátí zpět jeho účinky.
clearTimeout() a clearInterval() používají společný registr, takže technicky může kterákoli z těchto funkcí zrušit oba druhy časovačů. Kvůli čitelnosti kombinujte setTimeout() s clearTimeout() a setInterval() s clearInterval().
V příkladu dojde ke zrušení synchronně, ještě než se callback může vykonat. Zpoždění 0 neznamená okamžité vykonání, takže jedinou vypsanou zprávou je cancelled.
Příklady
(() => {
const id = setTimeout(() => console.log("unexpected"), 0);
clearTimeout(id);
console.log("cancelled");
})();Výsledek
cancelled
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.