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.