Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti