CKTIS / JavaScript
setInterval — chamar uma função repetidamente
setInterval() agenda chamadas repetidas a uma função com um atraso pedido em milissegundos. O identificador devolvido permite parar o temporizador com clearInterval(); não é garantido o momento exato da 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
const intervalId = setInterval(callback, delayMs, ...args);
clearInterval(intervalId);setInterval(callback, delayMs, ...args) é uma API Web definida pela norma HTML, não pelo ECMAScript. Está disponível em janelas do browser e em workers, e é suportada pelos motores de browser atuais. A presença deste nome no Node.js não prova que a API do browser seja suportada.
Passe uma função como callback, um atraso em milissegundos como delayMs e argumentos opcionais como ...args. A primeira chamada não é imediata. O método devolve um identificador de temporizador inteiro positivo; guarde-o e passe-o a clearInterval(intervalId) quando já não precisar do temporizador. Ao contrário de setTimeout(), que é executado uma única vez, este temporizador repete as chamadas.
O atraso não garante um agendamento exato: outras tarefas podem adiar a execução. Quando o nível de aninhamento dos temporizadores é superior a 5, os atrasos inferiores a 4 ms passam a 4 ms; isto também se aplica às repetições de setInterval(). Passe uma função em vez de uma cadeia de texto com código.
O exemplo apresenta 1, 2, 3 por ordem e cancela o temporizador durante a terceira chamada. Verifique a ordem e a paragem, não os intervalos de tempo exatos.
Exemplos
{
let count = 0;
const intervalId = setInterval(() => {
count += 1;
console.log(count);
if (count === 3) {
clearInterval(intervalId);
}
}, 100);
}Resultado
1 2 3
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.