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

CKTIS / JavaScript

Eventos DOMContentLoaded, pagehide y resize

Elige el evento adecuado: `DOMContentLoaded` cuando el DOM está listo, `pagehide` al dejar una página y `resize` cuando cambia el tamaño del área de visualización.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

document.addEventListener("DOMContentLoaded", onDomReady, { once: true });
window.addEventListener("pagehide", onPageHide);
window.addEventListener("resize", onResize);

DOMContentLoaded, pagehide y resize pertenecen a la plataforma web, no a ECMAScript 2024. Registra los escuchadores con addEventListener(): en document para el primero y en window para los otros dos. Su disponibilidad depende del entorno de ejecución; no des por hecho que un worker o Node.js ofrece estos destinos de eventos del navegador.

DOMContentLoaded es un Event no cancelable que se propaga desde document en la fase de burbujeo. El navegador lo dispara tras analizar el HTML, ejecutar los scripts clásicos con defer e iniciar la evaluación de los scripts de módulo programados para después del análisis (sin async). No espera a que termine la evaluación asíncrona de los módulos: un módulo puede seguir suspendido en un await de nivel superior o su cuerpo puede seguir sin ejecutarse a la espera de una dependencia asíncrona. A diferencia de load, no espera directamente a las imágenes, los marcos ni los scripts async. Si solo necesitas el DOM ya analizado, registra un escuchador con { once: true } cuando document.readyState === "loading"; si no, inicializa de inmediato. "interactive" no demuestra que el evento ya haya ocurrido ni que los scripts diferidos hayan preparado el estado que necesita tu código.

pagehide es un PageTransitionEvent que se escucha en window al dejar una página, no por el mero hecho de cambiar de pestaña. event.persisted === true indica que la página puede conservarse en la caché de navegación hacia atrás y adelante (bfcache); false indica que ese documento no se restaurará así. true no garantiza el regreso: detecta la restauración efectiva con pageshow y persisted === true, sin un nuevo DOMContentLoaded. preventDefault() no impide la navegación. pagehide puede no dispararse, sobre todo en móviles, así que guarda antes los datos importantes; para detectar el paso a segundo plano, usa visibilitychange y comprueba document.visibilityState === "hidden".

El resize de window es un Event no cancelable que no se propaga en la fase de burbujeo. Notifica cambios de tamaño del área de visualización, no de cualquier elemento. Lee las dimensiones actuales en window.innerWidth y window.innerHeight; para vigilar el tamaño de un elemento, usa ResizeObserver. Los cambios pueden sucederse rápidamente: limita la frecuencia de los cálculos de diseño costosos.

Ejemplos

(() => {
  const documentTarget = globalThis.document ?? new EventTarget();
  const windowTarget = globalThis.window ?? new EventTarget();
  const controller = new AbortController();
  const options = { signal: controller.signal };

  documentTarget.addEventListener("DOMContentLoaded", (event) => {
    console.log(event.type);
  }, options);
  windowTarget.addEventListener("pagehide", (event) => {
    console.log(`${event.type}: persisted=${event.persisted}`);
  }, options);
  windowTarget.addEventListener("resize", (event) => {
    console.log(event.type);
  }, options);

  try {
    documentTarget.dispatchEvent(new Event("DOMContentLoaded", { bubbles: true }));
    const pagehide = typeof PageTransitionEvent === "function"
      ? new PageTransitionEvent("pagehide", { persisted: true })
      : Object.assign(new Event("pagehide"), { persisted: true });
    windowTarget.dispatchEvent(pagehide);
    windowTarget.dispatchEvent(new Event("resize"));
  } finally {
    controller.abort();
  }
})();

Resultado

DOMContentLoaded
pagehide: persisted=true
resize

Ejecuta el código en la consola del navegador de una pestaña nueva `about:blank`, o guárdalo como `main.js` y ejecuta `node main.js` con Node.js 24. En Node.js, el ejemplo usa instancias independientes de `EventTarget` en lugar de `document` y `window`. Los eventos sintéticos comprueban el registro de los escuchadores; no cambian el estado del documento ni el tamaño del área de visualización, no provocan navegación y no ponen a prueba la bfcache. `abort()` elimina los tres escuchadores.

Lecciones relacionadas

  • JavaScript · Lección 34 · Avanzado · Versión: 4

Fuentes