Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje