CKTIS / JavaScript
Eventos DOMContentLoaded y pagehide
Usa `DOMContentLoaded` para inicializar el código cuando el DOM esté construido y `pagehide` para pausar el trabajo al salir del documento. Restaurar desde la bfcache no equivale a cargar de nuevo.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
document.addEventListener("DOMContentLoaded", onReady, { once: true });
window.addEventListener("pagehide", onPageHide);
window.addEventListener("pageshow", onPageShow);DOMContentLoaded es un Event que se dispara en document después de que el navegador termine de analizar el HTML, ejecute los scripts clásicos con defer e inicie la evaluación de los scripts de módulo sin async programados para el final del análisis. El evento no espera a que termine la evaluación de los módulos: si una dependencia se suspende en un await de nivel superior, el evento puede dispararse antes incluso de que empiece a ejecutarse el cuerpo del módulo que la importa. No espera a las imágenes, los marcos ni a que terminen los scripts async. Las hojas de estilo pueden retrasarlo indirectamente si bloquean la ejecución de scripts. Usa load en window si necesitas esperar a los recursos que retrasan la carga de la página.
Si el código de inicialización puede ejecutarse tarde, comprueba document.readyState: si vale "loading", registra un oyente de un solo uso para DOMContentLoaded; de lo contrario, usa el DOM ya disponible. "interactive" indica que ha terminado el análisis, no que el evento ya se haya disparado ni que otros scripts hayan terminado de inicializarse. Si dependes de ellos, establece explícitamente el orden de inicialización.
Escucha pagehide en window para reaccionar al salir del documento, por ejemplo al pulsar Atrás. Este PageTransitionEvent no indica un simple cambio de pestaña ni permite cancelar la navegación. event.persisted === true significa que el documento puede conservarse en la caché de navegación hacia atrás y adelante (bfcache), no que su restauración esté garantizada. false significa que no se conserva en esa navegación. Pausa el trabajo en pagehide y reanúdalo en pageshow si persisted === true: el documento restaurado conserva su DOM y no vuelve a disparar DOMContentLoaded.
Guarda los datos importantes conforme se produzcan. pagehide puede no dispararse, sobre todo si se fuerza el cierre de un navegador móvil, y el trabajo asíncrono iniciado en ese momento podría no terminar. Para reaccionar cuando la página pasa a estar oculta, escucha visibilitychange en document y comprueba el estado "hidden". Estas API son de la plataforma web, no funciones incorporadas en ECMAScript 2024.
Ejemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>DOMContentLoaded and pagehide</title>
<script>
(() => {
const init = () => console.log("DOM ready");
if (document.readyState === "loading") {
document.addEventListener("DOMContentLoaded", init, { once: true });
} else {
init();
}
window.addEventListener("pagehide", (event) => {
console.log(`pagehide persisted=${event.persisted}`);
});
window.addEventListener("pageshow", (event) => {
if (event.persisted) console.log("pageshow restored");
});
})();
</script>
</head>
<body>
<p>Open the browser console to see the event log.</p>
</body>
</html>Resultado
DOM ready
Guarda el ejemplo como archivo HTML y ábrelo en un navegador. Activa la opción de conservar el registro en la consola y recarga la página. `DOM ready` aparece cuando se dispara `DOMContentLoaded`. Los mensajes posteriores dependen de la navegación y de si el navegador conserva el documento.
Lecciones relacionadas
- JavaScript · Lección 40 · Avanzado · Versión: 4
- JavaScript · Lección 41 · Avanzado · Versión: 4