Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

setTimeout — pianificare una funzione una sola volta

setTimeout pianifica l’esecuzione di una funzione una sola volta senza bloccare il codice corrente. Il ritardo non garantisce un momento esatto di esecuzione e l’identificatore restituito permette di annullare l’invocazione in attesa.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

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

setTimeout è un’API definita dall’HTML Standard per finestre e worker, non una funzione di ECMAScript stesso. Pianifica una funzione per una sola invocazione; setInterval pianifica la ripetizione. Fornisci una funzione callback, un ritardo delayMs in millisecondi e gli args opzionali da passare alla funzione. Passa una funzione invece di testo di codice che richiederebbe la compilazione.

La chiamata ritorna senza attendere. Anche con un ritardo di 0, il callback aspetta un’attività successiva del loop degli eventi; non interrompe il codice sincrono corrente. Il momento indicato non è garantito e l’esecuzione può avvenire più tardi. Quando il livello di annidamento del timer supera 5, i ritardi inferiori a 4 ms vengono portati a 4 ms.

La pianificazione di una funzione restituisce un identificatore intero positivo id. clearTimeout(id) annulla l’invocazione in attesa nello stesso ambiente globale. Non arresta un callback già in esecuzione.

L’esempio annulla un timer e passa "timer" come argomento a un altro. Il codice sincrono aggiunge "end" prima che venga eseguito il callback del timer, quindi il risultato atteso è start -> end -> timer. Controlla l’ordine, non il tempo esatto trascorso.

Esempi

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

Risultato

start -> end -> timer

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti