CKTIS / JavaScript
Document.readyState — laadstatus van het document
Document.readyState beschrijft de laadfase van het document: loading, interactive of complete. Door deze eigenschap te controleren, kan DOM-gerelateerde code ook worden geïnitialiseerd wanneer een script te laat wordt geladen om DOMContentLoaded te ontvangen.
Versie: 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.readyStateDocument.readyState, gelezen als document.readyState, beschrijft de huidige laadstatus van het document. Het is een browser-Web-API, geen functie van de ECMAScript-taal. MDN classificeert de API sinds juli 2015 als breed beschikbaar in browsers; alleen de Node.js-versie toont niet aan dat deze API wordt ondersteund.
De waarde "loading" betekent dat de HTML-parser nog bezig is. Bij "interactive" is het document al geparseerd, maar afhankelijke bronnen kunnen nog worden geladen. Het document bereikt de status "complete" zodra het geladen is en geen enkele bron het load-event nog vertraagt. Na die statusovergang wordt het load-event geactiveerd. Afbeeldingen met loading="lazy" hoeven dan nog niet geladen te zijn, omdat ze dat event niet vertragen. Een statuswijziging activeert readystatechange op het document.
De status "interactive" betekent niet dat DOMContentLoaded al is geactiveerd: klassieke scripts met defer en modulescripts die na het parsen moeten worden uitgevoerd, kunnen nog op uitvoering wachten. Voordat de browser het event activeert, voert hij die klassieke scripts uit en start hij de evaluatie van die modules. Hij wacht niet tot een module die bij een await op het hoogste niveau is gepauzeerd, klaar is. Ook wacht hij niet op modulescripts met async of op afbeeldingen. Dat het DOM gereed is, betekent dus niet dat de pagina volledig is geladen.
Het voorbeeld wacht alleen bij "loading" op DOMContentLoaded; in andere gevallen roept het init() meteen aan. Zo wacht een laat uitgevoerd script niet op een event dat al heeft plaatsgevonden. Dit patroon geeft toegang tot het geparste DOM, maar garandeert niet dat andere defer- of modulescripts klaar zijn. { once: true } verwijdert de listener na de eerste aanroep.
Voorbeelden
(() => {
function init() {
console.log("DOM parsed");
}
if (document.readyState === "loading") {
document.addEventListener("DOMContentLoaded", init, { once: true });
} else {
init();
}
})();Resultaat
DOM parsed
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.