CKTIS / JavaScript
EventTarget.addEventListener — registrar escuchas de eventos
EventTarget.addEventListener registra una función de retorno para un evento. Las opciones capture, once y passive controlan cuándo se invoca y si la escucha puede cancelar el 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
target.addEventListener(type, callback, options);
// options: boolean capture, or { capture, once, passive, signal }EventTarget.addEventListener registra un callback para el tipo de evento type. El tercer argumento es un objeto de opciones o un valor booleano que representa capture. Esta API pertenece al estándar DOM, no a ECMAScript en sí.
capture: true selecciona la fase de captura en lugar de la propagación de burbujeo en los ancestros; cualquiera de los dos ajustes permite la invocación en el propio destino. Tanto capture como once tienen el valor predeterminado false. Con once: true, el registro se elimina antes de invocar callback. Si callback despacha un evento durante esa invocación, el despacho anidado no puede volver a invocar callback a través del mismo registro. passive: true impide cancelar mediante preventDefault(), pero no detiene la propagación. Para cancelar un evento cancelable, establece explícitamente passive: false: omitir la opción no siempre significa false.
Los duplicados se identifican por type, la identidad de callback y capture; volver a registrar no actualiza las opciones. removeEventListener requiere esos mismos tres valores. El ejemplo usa un destino independiente, así que no muestra la propagación entre elementos.
Ejemplos
const target = new EventTarget();
let calls = 0;
target.addEventListener('demo', (event) => {
calls++;
event.preventDefault();
}, { capture: false, once: true, passive: false });
const first = new Event('demo', { cancelable: true });
target.dispatchEvent(first);
target.dispatchEvent(new Event('demo'));
console.log(calls, first.defaultPrevented);Resultado
1 true
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.