CKTIS / JavaScript
setTimeout — naplánování funkce k jednorázovému spuštění
setTimeout naplánuje jednorázové spuštění funkce, aniž by blokoval aktuální kód. Zpoždění nezaručuje přesný čas spuštění a vrácený identifikátor umožňuje zrušit čekající volání.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
const id = setTimeout(callback, delayMs, ...args);
clearTimeout(id);setTimeout je API definované standardem HTML Standard pro okna a workery, nikoli funkce samotného ECMAScriptu. Naplánuje jednorázové zavolání funkce; setInterval plánuje opakování. Předej funkci callback, zpoždění delayMs v milisekundách a případné args, které funkce dostane. Předávej funkci, nikoli text kódu, který by vyžadoval kompilaci.
Volání se vrátí bez čekání. I při zpoždění 0 callback čeká na pozdější úlohu ve smyčce událostí; nepřeruší právě prováděný synchronní kód. Uvedený čas není zaručen a ke spuštění může dojít později. Pokud úroveň vnoření časovače překročí 5, zpoždění kratší než 4 ms se zvýší na 4 ms.
Při naplánování funkce se vrátí kladný celočíselný identifikátor id. clearTimeout(id) zruší čekající volání ve stejném globálním prostředí. Nezastaví callback, který se už provádí.
Příklad zruší jeden časovač a druhému předá jako argument "timer". Synchronní kód přidá "end" dříve, než se spustí callback časovače, takže očekávaný výsledek je start -> end -> timer. Ověř pořadí, ne přesný uplynulý čas.
Pří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ýsledek
start -> end -> timer
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.