CKTIS / JavaScript
Event.currentTarget — o objeto que trata um evento
Event.currentTarget identifica o objeto cujo listener está a ser chamado. Ao contrário de event.target, indica onde o evento é tratado, não o seu destino.
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
event.currentTargetEvent.currentTarget é uma propriedade só de leitura que devolve um EventTarget ou null. Durante a chamada de um listener, identifica o objeto em que esse listener foi registado; não tem de ser um elemento.
event.target representa o destino do evento, tendo em conta o redirecionamento do destino pelo Shadow DOM. event.currentTarget identifica o local onde o evento está a ser tratado durante as fases de captura e propagação. No exemplo, o destino é child, enquanto o listener é executado em parent.
Antes de o envio do evento começar e depois de terminar, currentTarget é null. Se precisares desse objeto mais tarde, por exemplo depois de await, guarda-o durante o tratamento síncrono em vez de leres a propriedade mais tarde a partir do evento guardado.
Exemplos
const parent = document.createElement('div');
const child = document.createElement('button');
parent.append(child);
const event = new Event('demo', { bubbles: true });
let savedTarget;
parent.addEventListener('demo', (event) => {
savedTarget = event.currentTarget;
console.log(event.target === child);
console.log(event.currentTarget === parent);
});
child.dispatchEvent(event);
console.log(event.currentTarget === null);
console.log(savedTarget === parent);Resultado
true true true 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.