Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

clearTimeout — zrušenie časovača

clearTimeout(id) zruší čakajúce volanie naplánované pomocou setTimeout(). Ak ho chcete zrušiť, odovzdajte identifikátor príslušného časovača, nie funkciu odovzdanú ako callback. Argument je nepovinný: pri volaní clearTimeout() bez argumentu sa použije predvolená hodnota 0 a nič sa nezruší.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

clearTimeout()
clearTimeout(id)

clearTimeout(id) zruší časovač určený hodnotou, ktorú vrátila funkcia setTimeout(). Vráti undefined. Ide o API štandardu HTML dostupné v oknách prehliadača a workeroch, nie o súčasť samotného ECMAScriptu. Štandard uvádza podporu vo všetkých súčasných jadrách prehliadačov; prítomnosť Node 24 nepotvrdzuje podporu API prehliadača.

Identifikátor si odložte a časovač zrušte v tom istom globálnom prostredí, v ktorom bol vytvorený. Identifikátor, ktorý sa nenachádza v registri časovačov, nič nezmení. Zrušenie nepreruší callback, ktorý sa už vykonáva, ani nevráti späť jeho účinky.

clearTimeout() a clearInterval() používajú spoločný register, takže technicky môže ktorákoľvek z týchto funkcií zrušiť oba druhy časovačov. Kvôli čitateľnosti kombinujte setTimeout() s clearTimeout() a setInterval() s clearInterval().

V príklade dôjde k zrušeniu synchrónne, skôr než sa callback môže vykonať. Oneskorenie 0 neznamená okamžité vykonanie, takže jedinou vypísanou správou je cancelled.

Príklady

(() => {
  const id = setTimeout(() => console.log("unexpected"), 0);
  clearTimeout(id);
  console.log("cancelled");
})();

Výsledok

cancelled

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje