CKTIS / JavaScript
clearTimeout — annullare un timer
clearTimeout(id) annulla una chiamata in attesa pianificata con setTimeout(). Per annullarla, passa l’identificatore del timer corrispondente, non la funzione di callback. L’argomento è facoltativo: senza argomento, clearTimeout() usa il valore predefinito 0 e non ha alcun effetto.
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
clearTimeout()
clearTimeout(id)clearTimeout(id) annulla il timer identificato dal valore restituito da setTimeout(). Restituisce undefined. È un’API dello standard HTML disponibile nelle finestre del browser e nei worker, non fa parte di ECMAScript in sé. Lo standard indica il supporto in tutti i motori browser attuali; la presenza di Node 24 non dimostra il supporto delle API del browser.
Conserva l’identificatore e annulla il timer nello stesso ambiente globale in cui è stato creato. Un identificatore assente dal registro dei timer non cambia nulla. L’annullamento non interrompe un callback già in esecuzione e non ne annulla gli effetti.
clearTimeout() e clearInterval() condividono un registro, quindi tecnicamente ciascuna delle due può annullare entrambi i tipi di timer. Per rendere il codice più leggibile, abbina setTimeout() a clearTimeout() e setInterval() a clearInterval().
Nell’esempio, l’annullamento avviene in modo sincrono prima che il callback possa essere eseguito. Un ritardo di 0 non significa esecuzione immediata, quindi l’unico messaggio visualizzato è cancelled.
Esempi
(() => {
const id = setTimeout(() => console.log("unexpected"), 0);
clearTimeout(id);
console.log("cancelled");
})();Risultato
cancelled
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.