Esta tradução está incompleta. Por favor, ajude a traduzir este artigo.

Sumário

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

Síntaxe

escopo.clearTimeout(timeoutID)

Parâmetros

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() e setInterval() são compartilhados, o que significa que clearTimeout() e clearInterval() podem ser tecnicamente utilizados de forma intercambiável. No entanto, para obter-se maior clareza, isso deve ser evitado.

Exemplo

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() };

Notas

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

Especificações

Especificação Status Comentário
HTML Living Standard
The definition of 'WindowOrWorkerGlobalScope.clearTimeout()' in that specification.
Padrão em tempo real Método movido para WindowOrWorkerGlobalScope .
HTML Living Standard
The definition of 'clearTimeout()' in that specification.
Padrão em tempo real  

Compatibilidade

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
clearTimeoutChrome Full support 45Edge Full support YesFirefox Full support 1
Full support 1
Full support 52
Notes
Notes clearTimeout() now defined on WindowOrWorkerGlobalScope mixin.
IE Full support 4Opera Full support 4Safari Full support 4WebView Android Full support 45Chrome Android Full support 45Edge Mobile Full support YesFirefox Android Full support 4
Full support 4
Full support 52
Notes
Notes clearTimeout() now defined on WindowOrWorkerGlobalScope mixin.
Opera Android Full support 6Safari iOS Full support 1Samsung Internet Android ?

Legend

Full support  
Full support
Compatibility unknown  
Compatibility unknown
See implementation notes.
See implementation notes.

Veja também

Etiquetas do documento e colaboradores

Etiquetas: 
Colaboradores desta página: mdnwebdocs-bot, GarkGarcia, teoli, Willkuns
Última atualização por: mdnwebdocs-bot,