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.