База знанияИзпитен център
BGБългарски
Избери език13

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.readyState

Document.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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници