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

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.

Fontes