Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

clearInterval — annullare un timer ripetuto

clearInterval(id) annulla il timer identificato dal valore restituito da setInterval(). Impedisce le invocazioni successive, ma non interrompe una funzione già in esecuzione.

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

clearInterval(id)

clearInterval(id) rimuove un timer ripetuto. Conserva l’identificatore numerico restituito da setInterval() e passalo nello stesso ambiente globale. È una Web API dello standard HTML, disponibile in finestre e worker, non una funzione definita da ECMAScript. Lo standard ne indica il supporto in tutti i motori browser attuali.

L’annullamento impedisce le invocazioni successive, ma non interrompe la funzione attualmente in esecuzione né annulla i suoi effetti. Un identificatore inesistente non cambia nulla; annullare di nuovo non provoca danni, a meno che quell’identificatore non venga riutilizzato. La chiamata restituisce undefined.

clearInterval() e clearTimeout() condividono una mappa degli identificatori, quindi ciascuna può annullare entrambi i tipi di timer. Per chiarezza, tuttavia, abbina setInterval() a clearInterval(). Gli identificatori appartengono a uno specifico ambiente globale, non a tutte le finestre e i worker nel loro insieme.

L’esempio annulla il timer durante la sua terza invocazione. Il codice dopo clearInterval(id) stampa comunque stopped. Il ritardo 20 non garantisce un intervallo di tempo esatto; verifica l’ordine dei risultati, non il momento in cui compaiono.

Esempi

(() => {
  let count = 0;
  const id = setInterval(() => {
    count += 1;
    console.log(count);
    if (count === 3) {
      clearInterval(id);
      console.log("stopped");
    }
  }, 20);
})();

Risultato

1
2
3
stopped

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