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

CKTIS / JavaScript

setTimeout — naplánovanie funkcie na jednorazové spustenie

setTimeout naplánuje jednorazové spustenie funkcie bez blokovania aktuálneho kódu. Oneskorenie nezaručuje presný čas spustenia a vrátený identifikátor umožňuje zrušiť čakajúce volanie.

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

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

setTimeout je API definované štandardom HTML Standard pre okná a workery, nie funkcia samotného ECMAScriptu. Naplánuje jednorazové zavolanie funkcie; setInterval plánuje opakovanie. Odovzdaj funkciu callback, oneskorenie delayMs v milisekundách a prípadné args, ktoré funkcia dostane. Odovzdávaj funkciu, nie text kódu, ktorý by vyžadoval kompiláciu.

Volanie sa vráti bez čakania. Aj pri oneskorení 0 callback čaká na neskoršiu úlohu v slučke udalostí; nepreruší práve vykonávaný synchrónny kód. Uvedený čas nie je zaručený a vykonanie môže nastať neskôr. Ak úroveň vnorenia časovača presiahne 5, oneskorenia kratšie ako 4 ms sa zvýšia na 4 ms.

Pri naplánovaní funkcie sa vráti kladný celočíselný identifikátor id. clearTimeout(id) zruší čakajúce volanie v tom istom globálnom prostredí. Nezastaví callback, ktorý sa už vykonáva.

Príklad zruší jeden časovač a druhému odovzdá ako argument "timer". Synchrónny kód pridá "end" pred spustením callbacku časovača, takže očakávaný výsledok je start -> end -> timer. Over poradie, nie presný uplynutý čas.

Príklady

(() => {
  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");
})();

Výsledok

start -> end -> timer

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

Zdroje