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

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.

Fuentes