CKTIS / JavaScript
CustomEvent.detail — datos de eventos personalizados
CustomEvent.detail expone los datos proporcionados al crear un evento. Su valor predeterminado es null; los objetos se pasan sin clonarse.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
const event = new CustomEvent(type, { detail: value });
event.detailCustomEvent.detail es una propiedad de instancia de CustomEvent que contiene los datos establecidos mediante la opción detail del constructor. Si se omite detail o se establece explícitamente en undefined, Web IDL aplica el valor predeterminado null, por lo que event.detail === null.
La propiedad es de solo lectura, pero no congela el objeto almacenado. El objeto no se clona: cambiar event.detail.count modifica el mismo objeto que se pasó al constructor.
Un listener lee los datos mediante event.detail. El ejemplo muestra la referencia compartida y el valor predeterminado null. Esta es una interfaz DOM, no una característica del lenguaje ECMAScript; que Node 24 esté presente en un repositorio no demuestra que haya compatibilidad en navegadores.
Ejemplos
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.