Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

clearInterval — cancelar um temporizador repetitivo

clearInterval(id) cancela o temporizador identificado pelo valor devolvido por setInterval(). Impede as chamadas seguintes, mas não interrompe uma função que já esteja em execução.

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

Sintaxe

clearInterval(id)

clearInterval(id) remove um temporizador repetitivo. Guarda o identificador numérico devolvido por setInterval() e passa-o no mesmo ambiente global. É uma API Web do padrão HTML, disponível em janelas e workers, e não uma função definida pelo ECMAScript. O padrão indica suporte em todos os motores de navegador atuais.

O cancelamento impede chamadas seguintes, mas não interrompe a função que está a ser executada nem anula os seus efeitos. Um identificador inexistente não altera nada; cancelar novamente não tem consequências, desde que esse identificador não seja reutilizado. A chamada devolve undefined.

clearInterval() e clearTimeout() partilham um mapa de identificadores, pelo que qualquer uma pode cancelar qualquer tipo de temporizador. Ainda assim, por uma questão de clareza, associa setInterval() a clearInterval(). Os identificadores pertencem a um ambiente global específico, não a todas as janelas e workers em conjunto.

O exemplo cancela o temporizador durante a terceira chamada. O código depois de clearInterval(id) continua a apresentar stopped. O atraso 20 não garante um intervalo de tempo exato; verifica a ordem dos resultados, não o momento em que aparecem.

Exemplos

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

Resultado

1
2
3
stopped

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes