CKTIS / JavaScript
DOMContentLoaded — disponibilidad del árbol DOM
DOMContentLoaded indica que han terminado el análisis del HTML y la ejecución de los scripts diferidos. Permite inicializar una interfaz sin esperar a que se cargue toda la página.
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
document.addEventListener("DOMContentLoaded", init, { once: true });DOMContentLoaded es un evento que se dispara en document cuando terminan el análisis del HTML y la ejecución de los scripts diferidos. Forma parte del estándar HTML, no de ECMAScript; los motores de los navegadores actuales lo admiten. Tener Node 24 no proporciona por sí solo el document del navegador.
No significa que se hayan cargado todos los recursos: no espera a las imágenes ni a los scripts async. El evento posterior load en window corresponde a una fase de carga más completa. Las hojas de estilo pueden retrasar indirectamente DOMContentLoaded al bloquear la ejecución de scripts diferidos.
Un listener añadido después del evento no se ejecuta retroactivamente. Por eso, el ejemplo comprueba document.readyState: si su valor es "loading", registra init; de lo contrario, la llama inmediatamente. El estado "interactive" significa que el análisis ha terminado, pero no demuestra que DOMContentLoaded ya se haya disparado. Este patrón gestiona la disponibilidad del DOM; no garantiza que se espere a los scripts diferidos que aún queden.
En el ejemplo, el script aparece antes del párrafo. La espera evita buscar el elemento demasiado pronto; después de la inicialización, tanto el párrafo como la consola muestran DOM ready.
Ejemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>DOMContentLoaded example</title>
<script>
function init() {
document.getElementById("status").textContent = "DOM ready";
console.log("DOM ready");
}
if (document.readyState === "loading") {
document.addEventListener("DOMContentLoaded", init, { once: true });
} else {
init();
}
</script>
</head>
<body>
<p id="status">Waiting</p>
</body>
</html>Resultado
DOM ready
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.