CKTIS / JavaScript
CustomEvent: eventos con datos personalizados
CustomEvent amplía Event con detail, lo que permite que los datos definidos por la aplicación lleguen a los listeners del evento.
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
new CustomEvent(type, { detail: null, bubbles: false, cancelable: false, composed: false })CustomEvent es una interfaz de la API Web del DOM Standard, no de ECMAScript. Su constructor acepta un nombre de evento y opciones opcionales. La opción detail permite transmitir cualquier valor de JavaScript excepto undefined. Si omites esta opción o pasas explícitamente undefined, Web IDL usa el valor predeterminado null. Los objetos no se copian.
Crear un evento no lo envía: llama a dispatchEvent() en un EventTarget. Registra los listeners con addEventListener(). El envío es síncrono. Las opciones bubbles, cancelable y composed tienen el valor false de forma predeterminada. Comprueba la disponibilidad de la API en el navegador de destino; la versión de Node del repositorio no la confirma.
Ejemplos
{
const target = new EventTarget();
target.addEventListener("score", (event) => {
console.log(`score=${event.detail}`);
});
target.dispatchEvent(new CustomEvent("score", { detail: 7 }));
console.log("done");
}Resultado
score=7 done
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.