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

CKTIS / JavaScript

Document.readyState — estado de carga del documento

Document.readyState describe la etapa de carga del documento: loading, interactive o complete. Comprobar esta propiedad ayuda a inicializar el código relacionado con el DOM incluso cuando un script se carga demasiado tarde para recibir DOMContentLoaded.

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.readyState

Document.readyState, leído como document.readyState, describe el estado de carga actual del documento. Es una API web del navegador, no una característica del lenguaje ECMAScript. MDN la clasifica como ampliamente disponible en los navegadores desde julio de 2015; la versión de Node.js por sí sola no demuestra que esta API sea compatible.

El valor "loading" significa que el analizador HTML sigue trabajando. En "interactive", el documento ya se ha analizado, pero puede que aún se estén cargando recursos dependientes. El documento alcanza el estado "complete" cuando termina de cargarse y ningún recurso sigue retrasando el evento load. El evento load se dispara después de este cambio de estado. Las imágenes con loading="lazy" pueden seguir pendientes de carga porque no retrasan ese evento. Un cambio de estado dispara readystatechange en el documento.

El estado "interactive" no significa que ya se haya disparado DOMContentLoaded: los scripts clásicos con defer y los scripts de módulo que deben ejecutarse después del análisis del documento aún pueden estar pendientes de ejecución. Antes de disparar el evento, el navegador ejecuta esos scripts clásicos e inicia la evaluación de esos módulos. No espera a que termine la evaluación de un módulo suspendido por un await de nivel superior, ni espera a los scripts de módulo con async o a las imágenes. Por tanto, que el DOM esté listo no significa que la página se haya cargado por completo.

El ejemplo espera a DOMContentLoaded solo cuando el estado es "loading"; en los demás casos, llama a init() de inmediato. Así, un script que se ejecuta tarde no espera a un evento que ya ha ocurrido. Este patrón permite acceder al DOM analizado, pero no garantiza que hayan terminado otros scripts defer o de módulo. { once: true } elimina el listener después de su primera llamada.

Ejemplos

(() => {
  function init() {
    console.log("DOM parsed");
  }

  if (document.readyState === "loading") {
    document.addEventListener("DOMContentLoaded", init, { once: true });
  } else {
    init();
  }
})();

Resultado

DOM parsed

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