Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

EventTarget — receber e despachar eventos

EventTarget é uma interface da Web API para registar ouvintes e despachar eventos. É possível criar uma instância autónoma sem um elemento DOM.

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

const target = new EventTarget();
target.addEventListener(type, callback, options);
target.removeEventListener(type, callback, options);
const notCanceled = target.dispatchEvent(event);

EventTarget é uma interface da Web API, não faz parte da norma ECMAScript. new EventTarget() cria um destino de eventos autónomo, sem um elemento ascendente na árvore de propagação.

addEventListener() regista um ouvinte. removeEventListener() exige o mesmo tipo de evento, a mesma referência da função de retorno de chamada e um valor capture correspondente. Com once: true, o registo do ouvinte é removido automaticamente antes de a sua função de retorno de chamada ser invocada. Se essa função despachar um novo evento do mesmo tipo no mesmo destino, o registo removido não dá origem a uma nova invocação.

dispatchEvent() invoca os ouvintes de forma síncrona. Devolve false se o indicador de cancelamento do evento estiver ativo; caso contrário, devolve true. Num evento cancelável, tanto uma chamada a preventDefault() como a atribuição event.returnValue = false, mantida por motivos de compatibilidade, podem ativar esse indicador. O resultado não indica se existe um ouvinte. O exemplo requer um ambiente que disponibilize EventTarget e Event, mas não precisa de um navegador. Funciona sem alterações no Node.js 24, o que não comprova a compatibilidade com navegadores.

Exemplos

const target = new EventTarget();
const log = [];

function onPing(event) {
  log.push(event.type);
  event.preventDefault();
}

target.addEventListener('ping', onPing, { once: true });
const first = target.dispatchEvent(new Event('ping', { cancelable: true }));
const second = target.dispatchEvent(new Event('ping', { cancelable: true }));

console.log(log.join(','));
console.log(first);
console.log(second);

Resultado

ping
false
true

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.

Fontes