CKTIS / JavaScript
EventTarget — recibir y emitir eventos
EventTarget es una interfaz de la API Web para registrar escuchas y emitir eventos. Se puede crear una instancia independiente sin un elemento DOM.
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 target = new EventTarget();
target.addEventListener(type, callback, options);
target.removeEventListener(type, callback, options);
const notCanceled = target.dispatchEvent(event);EventTarget es una interfaz de la API Web, no forma parte del estándar ECMAScript. new EventTarget() crea un destino de eventos independiente, sin padre en el árbol de propagación.
addEventListener() registra una escucha. removeEventListener() requiere el mismo tipo de evento, la misma referencia al callback y un valor capture coincidente. Con once: true, el registro de la escucha se elimina automáticamente antes de invocar su callback. Si esa función emite un nuevo evento del mismo tipo en el mismo destino, el registro eliminado no hace que la función se invoque de nuevo.
dispatchEvent() invoca las escuchas de forma síncrona. Devuelve false si el indicador de cancelación del evento está activado; en caso contrario, devuelve true. En un evento cancelable, tanto una llamada a preventDefault() como la asignación event.returnValue = false, que se conserva por compatibilidad, pueden activar ese indicador. El resultado no indica si existe una escucha. El ejemplo requiere un entorno que proporcione EventTarget y Event, pero no necesita un navegador. Se ejecuta sin cambios en Node.js 24, lo que no demuestra su compatibilidad con los navegadores.
Ejemplos
const target = new EventTarget();
const log = [];
function onPing(event) {
log.push(event.type);
event.preventDefault();
}
target.addEventListener('ping', onPing, { once: true });
const first = target.dispatchEvent(new Event('ping', { cancelable: true }));
const second = target.dispatchEvent(new Event('ping', { cancelable: true }));
console.log(log.join(','));
console.log(first);
console.log(second);Resultado
ping false 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.