WindowTimers.clearTimeout()

O método clearTimeout() do escopo WindowOrWorkerGlobalScope cancela um timeout previamente estabelecido pela função setTimeout() (en-US).

escopo.clearTimeout(timeoutID)

timeoutID

O ID do timeout que você deseja cancelar. Esse ID é o retorno da função setTimeout().

É interessante ressaltar que os conjuntso de IDs usados pelos métodos setTimeout() (en-US) e setInterval() são compartilhados, o que significa que clearTimeout() e clearInterval() (en-US) podem ser tecnicamente utilizados de forma intercambiável. No entanto, para obter-se maior clareza, isso deve ser evitado.

Execute o script abaixo em uma página web e clique na página uma vez. Você verá uma mensagem aparecer um segundo depois. Se você continuar clicando na página várias vezes nesse intervalo de tempo, a mensagem aparecerá uma única vez.

var alarme = {
  relembrar: function(aMessage) {
    alert(aMessage);
    delete this.timeoutID;
  },

  setup: function() {
    if (typeof this.timeoutID === 'number') {
        this.cancelar();
    }

    this.timeoutID = window.setTimeout(function(msg) {
        this.relembrar(msg);
    }.bind(this), 1000, 'Wake up!');
  },

  cancelar: function() {
    window.clearTimeout(this.timeoutID);
  }
};
window.onclick = function() { alarme.setup() };

Passar um ID inválido para clearTimeout não causa nenhum efeito (não lança nenhuma exceção).

• WindowOrWorkerGlobalScope.setTimeout() (en-US)
• WindowOrWorkerGlobalScope.setInterval()
• WindowOrWorkerGlobalScope.clearInterval() (en-US)
• Window.requestAnimationFrame()
• Daemons management