CKTIS / JavaScript
Eventos del navegador y propagación
Los eventos permiten reaccionar a las acciones del usuario y a cambios en el estado de la página. Aprende las fases de captura, destino y burbujeo, distingue entre cancelar la acción predeterminada y detener la propagación, y conoce los eventos de ciclo de vida, visibilidad, desplazamiento, tamaño y entrada.
Versión: Web APIs defined by web standards, not ECMAScript editions. Check support in target browsers; Node 24 in the repository does not establish browser API support.
Sintaxis
target.addEventListener(type, handler, options);
target.removeEventListener(type, handler, options);
target.dispatchEvent(event);Modelo y alcance
Los eventos del navegador forman parte de las API del entorno anfitrión, no de la sintaxis de ECMAScript. El estándar DOM define el modelo de eventos, su envío y propagación y las opciones de los listeners. El estándar HTML especifica, entre otras cosas, cuándo se disparan DOMContentLoaded y load, así como input y change en los controles de formulario. No vincules estas API a ninguna edición de ECMAScript. Node 24 no acredita la compatibilidad con las API del navegador. Compruébala en los navegadores de destino.
Propagación y cancelación
addEventListener(type, handler, options) registra un manejador. Hay captura en los ancestros, fase de destino y, si bubbles es verdadero, burbujeo en los ancestros. target indica el destino; currentTarget, el objeto del listener activo. stopPropagation() detiene la propagación sin omitir los listeners restantes de la ronda de llamadas en curso. Sin embargo, si un listener de captura en el destino llama a stopPropagation(), no se realiza la ronda separada de llamadas a los listeners sin captura de ese mismo destino. stopImmediatePropagation() también omite los listeners restantes de la ronda en curso. preventDefault() cancela la acción predeterminada solo si el evento es cancelable y el listener no es pasivo. No corta la propagación.
Ciclo de vida y visibilidad
DOMContentLoaded en document: terminan el análisis y los scripts que lo retrasan, no necesariamente la carga de recursos. load en window espera también los recursos que lo retrasan. pageshow y pagehide abarcan la caché de atrás/adelante; comprueba persisted. Ante visibilitychange en document, lee document.visibilityState. Oculta no significa cerrada; unload no garantiza un guardado final.
Desplazamiento, tamaño y entrada
scroll afecta al destino que se desplaza; resize en window, al tamaño del área visible. No todo burbujea. Mantén ligeros los manejadores frecuentes. input indica edición del usuario; change, confirmación según el control. Asignar .value no emite ninguno. Distingue keydown, eventos de puntero y click semántico; no dependas solo del ratón.
Gestión de listeners
once retira el listener antes de llamar por primera vez a su manejador. Si ese manejador emite de forma síncrona otro evento del mismo tipo, el listener retirado no lo procesa. passive impide que preventDefault() surta efecto y signal permite retirarlo por aborto. Para removeEventListener conserva tipo, referencia de función y valor de capture. En el ejemplo, dispatchEvent() es síncrono: false indica cancelación, no que se haya detenido la propagación.
Identificadores de referencia incluidos en esta entrada: Page lifecycle, visibility, scroll/resize and input events.
Ejemplos
(() => {
const parent = document.createElement('div');
const child = document.createElement('button');
parent.append(child);
const log = [];
parent.addEventListener('demo', () => log.push('capture'), { capture: true });
child.addEventListener('demo', event => {
log.push('target');
event.preventDefault();
});
parent.addEventListener('demo', () => log.push('bubble'));
const accepted = child.dispatchEvent(new Event('demo', {
bubbles: true,
cancelable: true
}));
console.log(log.join(' > '));
console.log(accepted);
})();Resultado
capture > target > bubble false
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
- DOM Standard — Events, dispatch, propagation, and listener options
- Official reference — developer.mozilla.org: API / PageTransitionEvent
- HTML Standard — End of parsing, DOMContentLoaded, and load
- MDN Web Docs — Document: visibilitychange event
- MDN Web Docs — Window: unload event
- CSSOM View Module — Scroll and resize event processing
- HTML Standard — Common input element events
- UI Events — Keyboard and click events
- Pointer Events