Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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

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

Fuentes