Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri