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

CKTIS / JavaScript

CustomEvent.detail — dados de eventos personalizados

CustomEvent.detail expõe os dados fornecidos ao criar um evento. O valor predefinido é null; os objetos são passados sem serem clonados.

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 event = new CustomEvent(type, { detail: value });
event.detail

CustomEvent.detail é uma propriedade de instância de CustomEvent que contém os dados definidos através da opção detail do construtor. Se a opção detail for omitida ou definida explicitamente como undefined, a Web IDL aplica o valor predefinido null, pelo que event.detail === null.

A propriedade é apenas de leitura, mas não congela o objeto armazenado. O objeto não é clonado: alterar event.detail.count modifica o mesmo objeto que foi passado ao construtor.

Um listener lê os dados através de event.detail. O exemplo demonstra a referência partilhada e o valor predefinido null. Trata-se de uma interface DOM, não de uma funcionalidade da linguagem ECMAScript; a presença de Node 24 num repositório não comprova o suporte nos browsers.

Exemplos

const target = new EventTarget();
const payload = { count: 1 };

 target.addEventListener("count-change", (event) => {
  console.log(event.detail === payload);
  event.detail.count += 1;
});

target.dispatchEvent(new CustomEvent("count-change", { detail: payload }));
console.log(payload.count);
console.log(new CustomEvent("empty").detail);

Resultado

true
2
null

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