CKTIS / JavaScript
clearTimeout — preklic časovnika
clearTimeout(id) prekliče čakajoči klic, načrtovan s setTimeout(). Za preklic podajte identifikator ustreznega časovnika, ne funkcije, podane kot callback. Argument ni obvezen: klic clearTimeout() brez argumenta uporabi privzeto vrednost 0 in nima učinka.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
clearTimeout()
clearTimeout(id)clearTimeout(id) prekliče časovnik, določen z vrednostjo, ki jo vrne setTimeout(). Vrne undefined. Gre za API standarda HTML, ki je na voljo v oknih brskalnika in delavcih, ni pa del samega ECMAScripta. Standard navaja podporo v vseh trenutnih brskalniških pogonih; prisotnost Node 24 ne potrjuje podpore za brskalniške API-je.
Identifikator shranite in časovnik prekličite v istem globalnem okolju, v katerem je bil ustvarjen. Identifikator, ki ga ni v registru časovnikov, ne spremeni ničesar. Preklic ne prekine callbacka, ki se že izvaja, in ne razveljavi njegovih učinkov.
clearTimeout() in clearInterval() uporabljata skupni register, zato lahko tehnično katera koli od njiju prekliče obe vrsti časovnikov. Zaradi berljivosti povežite setTimeout() s clearTimeout() ter setInterval() s clearInterval().
V primeru se preklic zgodi sinhrono, preden se callback lahko izvede. Zakasnitev 0 ne pomeni takojšnje izvedbe, zato je edino izpisano sporočilo cancelled.
Primeri
(() => {
const id = setTimeout(() => console.log("unexpected"), 0);
clearTimeout(id);
console.log("cancelled");
})();Rezultat
cancelled
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.