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.