Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje