A função associada ao evento
Um listener é uma função ou objeto registrado para executar um tratamento quando determinado evento ocorre. No navegador, addEventListener() associa esse tratamento a um alvo, como um botão, e a um tipo de evento, como click. A função recebe um objeto que descreve o evento.
O alvo mantém os registros dos seus listeners. Quando o evento alcança esse alvo na fase configurada, o navegador chama os tratamentos correspondentes. O evento pode percorrer outros elementos da página conforme sua propagação, por isso uma ação também pode acionar um listener registrado num elemento que contém o botão.
Um botão que responde uma vez
O exemplo didático pressupõe que a página já contém um botão com o identificador confirmar quando o script roda:
const botao = document.getElementById('confirmar');
botao.addEventListener('click', () => { botao.textContent = 'Confirmado';}, { once: true });O registro deixa o botão pronto para responder ao clique. Quando a função é chamada, o texto do botão muda para Confirmado. A opção once: true remove esse listener após a primeira chamada, então os próximos cliques não executam novamente esse tratamento. Ela não desativa o botão nem remove outros listeners associados a ele.
Registros duplicados
O navegador evita acrescentar outro registro com o mesmo tipo de evento, a mesma função e o mesmo valor de capture no mesmo alvo. Essa correspondência usa a identidade da função. Duas funções anônimas criadas separadamente continuam distintas, mesmo quando possuem o mesmo código.
Ao investigar uma resposta duplicada, confira onde a função é criada e quantas vezes o registro acontece. Uma rotina de inicialização repetida pode adicionar novos listeners sem que tenham ocorrido dois cliques.
Dúvidas frequentes
Perguntas frequentes sobre listener
- Adicionar um listener executa a função imediatamente?
- O registro mantém a função disponível para um evento futuro. O navegador a chama quando um evento compatível alcança aquele alvo na fase configurada.
- Como remover um listener no navegador?
- Use removeEventListener no mesmo alvo, com o mesmo tipo de evento e a mesma referência de função usados no registro. O valor de capture também precisa corresponder.
- Duas funções anônimas iguais geram um único registro?
- Cada expressão de função cria um objeto distinto. Duas funções com o mesmo texto podem ser registradas separadamente e executar duas respostas ao mesmo evento.
Para continuar
Recursos relacionados
Documentação
MDN: registro de listeners no navegador
Referência sobre o registro de listeners, a opção once e o uso de funções anônimas.
Abrir recursoSite de referência
Dev Side Studio: desenvolvimento colaborativo
Sessão prática para investigar eventos duplicados ou cliques sem resposta, com orientação enquanto você revisa o código da interface.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Na revisão de uma interface feita com agentes, você confere os listeners registrados no botão para investigar uma ação executada duas vezes.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.