WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Document.readyState — Ladezustand des Dokuments

Document.readyState beschreibt die Ladephase des Dokuments: loading, interactive oder complete. Eine Prüfung dieser Eigenschaft hilft dabei, DOM-bezogene Initialisierung auch dann auszuführen, wenn ein Skript zu spät geladen wird, um DOMContentLoaded zu empfangen.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

document.readyState

Document.readyState, gelesen als document.readyState, beschreibt den aktuellen Ladezustand des Dokuments. Es handelt sich um eine Browser-Web-API und nicht um ein Merkmal der ECMAScript-Sprache. MDN stuft sie seit Juli 2015 als in Browsern weit verbreitet ein; allein eine Node.js-Version belegt nicht, dass diese API unterstützt wird.

Der Wert "loading" bedeutet, dass der HTML-Parser noch arbeitet. Bei "interactive" wurde das Dokument bereits geparst, abhängige Ressourcen können jedoch noch geladen werden. Das Dokument erreicht den Zustand "complete", sobald es fertig geladen ist und keine Ressource mehr das load-Ereignis verzögert. Nach diesem Übergang wird das load-Ereignis ausgelöst. Bilder mit loading="lazy" können zu diesem Zeitpunkt noch nicht geladen sein, da sie dieses Ereignis nicht verzögern. Eine Zustandsänderung löst readystatechange auf dem Dokument aus.

Der Zustand "interactive" bedeutet nicht, dass DOMContentLoaded bereits ausgelöst wurde: Klassische Skripte mit defer und Modulskripte, die nach dem Parsen ausgeführt werden sollen, können noch auf ihre Ausführung warten. Bevor der Browser das Ereignis auslöst, führt er diese klassischen Skripte aus und stößt die Auswertung dieser Module an. Er wartet jedoch weder darauf, dass ein bei einem await auf oberster Ebene pausiertes Modul seine Ausführung beendet, noch auf Modulskripte mit async oder auf Bilder. Ein bereites DOM bedeutet daher nicht, dass die Seite vollständig geladen ist.

Das Beispiel wartet nur bei "loading" auf DOMContentLoaded; andernfalls ruft es init() sofort auf. So wartet ein spät ausgeführtes Skript nicht auf ein Ereignis, das bereits vorbei ist. Dieses Muster ermöglicht den Zugriff auf das geparste DOM, garantiert aber nicht, dass andere defer- oder Modulskripte abgeschlossen sind. { once: true } entfernt den Listener nach dem ersten Aufruf.

Beispiele

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

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

Ergebnis

DOM parsed

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen