CKTIS / JavaScript
DOMContentLoaded — готовност на DOM дървото
DOMContentLoaded сигнализира, че парсването на HTML и изпълнението на отложените скриптове са приключили. Позволява да инициализирате интерфейс, без да чакате цялата страница да се зареди.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
document.addEventListener("DOMContentLoaded", init, { once: true });DOMContentLoaded е събитие, което се задейства върху document, след като парсването на HTML и изпълнението на отложените скриптове приключат. То е част от стандарта HTML, а не от ECMAScript; съвременните браузърни енджини го поддържат. Самото наличие на Node 24 не осигурява браузърния document.
Това не означава, че всички ресурси са заредени: събитието не изчаква изображения или скриптове async. По-късното събитие load върху window съответства на по-пълен етап на зареждане. Стиловите таблици могат косвено да забавят DOMContentLoaded, като блокират изпълнението на отложени скриптове.
Listener, добавен след събитието, не се изпълнява със задна дата. Затова примерът проверява document.readyState: ако стойността е "loading", регистрира init; в противен случай я извиква веднага. Състоянието "interactive" означава, че парсването е приключило, но не доказва, че DOMContentLoaded вече се е задействало. Този модел обработва готовността на DOM; той не гарантира изчакване на оставащите отложени скриптове.
В примера скриптът е преди абзаца. Изчакването предотвратява търсенето на елемента твърде рано; след инициализацията и абзацът, и конзолата показват DOM ready.
Примери
<!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>Резултат
DOM ready
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.