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

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