CKTIS / JavaScript
Document.readyState — състояние на зареждане на документа
Document.readyState описва етапа на зареждане на документа: loading, interactive или complete. Проверката на това свойство помага за инициализиране на код, свързан с DOM, дори когато скриптът се зареди твърде късно, за да получи DOMContentLoaded.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
document.readyStateDocument.readyState, прочетено като document.readyState, описва текущото състояние на зареждане на документа. Това е Web API на браузъра, а не функция на езика ECMAScript. MDN го класифицира като широко достъпно в браузърите от юли 2015 г.; само версията на Node.js не доказва поддръжка на този API.
Стойността "loading" означава, че HTML парсерът все още работи. При "interactive" документът вече е анализиран, но зависимите ресурси може все още да се зареждат. Документът преминава в състояние "complete", когато зареждането му приключи и никой ресурс вече не забавя събитието load. Събитието load се задейства след този преход. Изображенията с loading="lazy" може все още да не са заредени, тъй като не забавят това събитие. Промяна на състоянието задейства readystatechange върху документа.
Състоянието "interactive" не означава, че DOMContentLoaded вече е задействано: класическите скриптове с defer и модулните скриптове, предвидени за изпълнение след анализа на документа, може още да чакат изпълнение. Преди да задейства събитието, браузърът изпълнява тези класически скриптове и започва изпълнението на тези модули. Той не изчаква да завърши изпълнението на модул, временно спряно при await на най-горно ниво, нито изчаква модулните скриптове с async или изображенията. Следователно готовият DOM не означава, че страницата е напълно заредена.
Примерът изчаква DOMContentLoaded само когато състоянието е "loading"; във всички останали случаи извиква init() незабавно. Така скрипт, изпълнен късно, не чака събитие, което вече е настъпило. Този шаблон осигурява достъп до анализирания DOM, но не гарантира, че другите скриптове defer или модулните скриптове са приключили. { once: true } премахва слушателя след първото му извикване.
Примери
(() => {
function init() {
console.log("DOM parsed");
}
if (document.readyState === "loading") {
document.addEventListener("DOMContentLoaded", init, { once: true });
} else {
init();
}
})();Резултат
DOM parsed
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.