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

CKTIS / JavaScript

setTimeout — enkratno načrtovanje funkcije

setTimeout načrtuje enkratno izvedbo funkcije, ne da bi blokiral trenutno kodo. Zakasnitev ne zagotavlja natančnega časa izvedbe, vrnjeni identifikator pa omogoča preklic čakajočega klica.

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

const id = setTimeout(callback, delayMs, ...args);
clearTimeout(id);

setTimeout je API, ki ga HTML Standard določa za okna in workerje; ni funkcija samega ECMAScripta. Načrtuje enkratni klic funkcije, medtem ko setInterval načrtuje ponavljanje. Podaj funkcijo callback, zakasnitev delayMs v milisekundah in morebitne args, ki jih funkcija prejme. Podaj funkcijo namesto besedila kode, ki bi zahtevalo prevajanje.

Klic se vrne, ne da bi čakal. Tudi pri zakasnitvi 0 callback počaka na poznejšo nalogo v zanki dogodkov; trenutne sinhrone kode ne prekine. Navedeni čas ni zagotovljen, izvedba pa se lahko zgodi pozneje. Ko raven gnezdenja časovnika preseže 5, se zakasnitve, krajše od 4 ms, povečajo na 4 ms.

Pri načrtovanju funkcije se vrne pozitivno celoštevilsko število id. clearTimeout(id) prekliče čakajoči klic v istem globalnem okolju. Ne ustavi callbacka, ki se že izvaja.

Primer prekliče en časovnik, drugemu pa kot argument poda "timer". Sinhrona koda doda "end", preden se izvede callback časovnika, zato je pričakovani rezultat start -> end -> timer. Preveri vrstni red, ne natančnega pretečenega časa.

Primeri

(() => {
  const events = ["start"];
  const id = setTimeout(() => events.push("cancelled"), 0);
  clearTimeout(id);

  setTimeout((message) => {
    events.push(message);
    console.log(events.join(" -> "));
  }, 0, "timer");

  events.push("end");
})();

Rezultat

start -> end -> timer

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri