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.