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

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.currentTarget

Event.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.

Fontes