CKTIS / JavaScript
clearTimeout — cancelar um temporizador
clearTimeout(id) cancela uma chamada pendente agendada com setTimeout(). Para a cancelar, passa o identificador do temporizador correspondente, não a função de callback. O argumento é opcional: se chamares clearTimeout() sem argumento, é usado o valor predefinido 0 e a chamada não tem efeito.
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
clearTimeout()
clearTimeout(id)clearTimeout(id) cancela o temporizador identificado pelo valor devolvido por setTimeout(). Devolve undefined. É uma API do padrão HTML disponível em janelas de navegador e workers, não fazendo parte do próprio ECMAScript. O padrão indica suporte em todos os motores de navegador atuais; a presença do Node 24 não comprova o suporte de APIs de navegador.
Guarda o identificador e cancela o temporizador no mesmo ambiente global em que foi criado. Um identificador que não esteja no registo de temporizadores não altera nada. O cancelamento não interrompe um callback que já esteja a ser executado nem desfaz os seus efeitos.
clearTimeout() e clearInterval() partilham um registo, pelo que, tecnicamente, qualquer uma pode cancelar ambos os tipos de temporizador. Para facilitar a leitura, combina setTimeout() com clearTimeout() e setInterval() com clearInterval().
No exemplo, o cancelamento acontece de forma síncrona antes de o callback poder ser executado. Um atraso de 0 não significa execução imediata, por isso a única mensagem apresentada é cancelled.
Exemplos
(() => {
const id = setTimeout(() => console.log("unexpected"), 0);
clearTimeout(id);
console.log("cancelled");
})();Resultado
cancelled
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.