EventTarget.removeEventListener()

Remove o event listener anteriormente registrado comEventTarget.addEventListener().

Sintaxe

target.removeEventListener(type, listener[, useCapture])
type

Uma string indicando o tipo de evento a ser removido.

listener

A funçãoEventListenera ser removida do event target.

useCaptureOptional

Indica quando oEventListenera ser removido foi registrado ou não comocapturing listener.Caso este parâmetro seja omitido, o valorfalseserá assumido por padrão.

Se um listener foi registrado duas vezes, uma com o parâmetrocaptureespecificado e outra sem, cada um deve ser removido separadamente. A remoção de umcapturing listenernão afeta a versãonon-capturingdo mesmo listener, e vice versa.

Nota:useCaptureera obrigatório em versões mais antigas dos navegadores. Para ampla compatibilidade, sempre informe o parâmetrouseCapture.

Notas

Se umEventListeneré removido de umEventTargetenquantoesteestá processando um evento, esse não será disparado pelascurrent actions.UmEventListenernão será invocado para o evento o qual foi registrado depois de ter sido removido, porém pode ser registrado novamente.

ChamarremoveEventListener()com argumentos que não identifiquem nenhumEventListenerregistrado noEventTargetnão tem qualquer efeito.

Exemplo

Este é um exemplo de como associar e remover um event listener.

js
vardiv=document.getElementById("div");
varlistener=function(event){
/* faça alguma coisa... */
};
div.addEventListener("click",listener,false);
div.removeEventListener("click",listener,false);

Especificações

Specification
DOM Standard
#ref-for-dom-eventtarget-removeeventlistener②

Compatibilidade com navegadores

BCD tables only load in the browser

Veja também