WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

DOMContentLoaded — Bereitschaft des DOM-Baums

DOMContentLoaded signalisiert, dass das Parsen des HTML-Dokuments und die Ausführung aufgeschobener Skripte abgeschlossen sind. Damit lässt sich eine Benutzeroberfläche initialisieren, ohne auf das vollständige Laden der Seite zu warten.

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.addEventListener("DOMContentLoaded", init, { once: true });

DOMContentLoaded ist ein Ereignis, das bei document ausgelöst wird, nachdem das HTML-Dokument geparst und die Ausführung aufgeschobener Skripte abgeschlossen wurde. Es gehört zum HTML-Standard, nicht zu ECMAScript; aktuelle Browser-Engines unterstützen es. Node 24 allein stellt das Browser-document nicht bereit.

Das Ereignis bedeutet nicht, dass alle Ressourcen geladen sind: Es wartet weder auf Bilder noch auf async-Skripte. Das spätere Ereignis load auf window steht für einen weiter fortgeschrittenen Ladezustand. Stylesheets können DOMContentLoaded indirekt verzögern, indem sie die Ausführung aufgeschobener Skripte blockieren.

Ein nach dem Ereignis hinzugefügter Listener wird nicht rückwirkend ausgeführt. Deshalb prüft das Beispiel document.readyState: Ist der Wert "loading", registriert es init; andernfalls ruft es die Funktion sofort auf. Der Zustand "interactive" bedeutet, dass das Parsen abgeschlossen ist, beweist aber nicht, dass DOMContentLoaded bereits ausgelöst wurde. Dieses Muster behandelt die Bereitschaft des DOM; es garantiert nicht, dass auf noch ausstehende aufgeschobene Skripte gewartet wird.

Das Skript im Beispiel steht vor dem Absatz. Das Warten verhindert, dass das Element zu früh gesucht wird; nach der Initialisierung zeigen sowohl der Absatz als auch die Konsole DOM ready an.

Beispiele

<!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>

Ergebnis

DOM ready

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