CKTIS / JavaScript
DOMContentLoaded — gotowość drzewa DOM
DOMContentLoaded sygnalizuje zakończenie parsowania HTML i wykonanie skryptów odroczonych. Pozwala inicjalizować interfejs bez czekania na pełne załadowanie strony.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
document.addEventListener("DOMContentLoaded", init, { once: true });DOMContentLoaded to zdarzenie wywoływane na document po zakończeniu parsowania HTML i wykonaniu skryptów odroczonych. Jest częścią standardu HTML, a nie ECMAScript; współczesne silniki przeglądarek je obsługują. Sama obecność Node 24 nie zapewnia przeglądarkowego document.
Nie oznacza pełnego załadowania zasobów: nie czeka na obrazy ani skrypty async. Późniejsze zdarzenie load na window dotyczy pełniejszego etapu ładowania. Arkusze stylów mogą pośrednio opóźniać DOMContentLoaded, blokując wykonanie skryptów odroczonych.
Nasłuchiwanie dodane po zdarzeniu nie uruchomi funkcji wstecznie. Dlatego przykład sprawdza document.readyState: przy "loading" rejestruje init, a w przeciwnym razie wywołuje ją od razu. Stan "interactive" oznacza zakończenie parsowania, lecz nie dowodzi, że DOMContentLoaded już wystąpiło. Ten wzorzec służy gotowości DOM, nie gwarantuje oczekiwania na pozostałe skrypty odroczone.
Skrypt w przykładzie znajduje się przed akapitem. Oczekiwanie zapobiega zbyt wczesnemu wyszukaniu elementu; po inicjalizacji akapit i konsola pokazują DOM ready.
Przykłady
<!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>Wynik
DOM ready
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.