CKTIS / JavaScript
Document.readyState — stato di caricamento del documento
Document.readyState descrive la fase di caricamento del documento: loading, interactive oppure complete. Controllare questa proprietà aiuta a inizializzare il codice relativo al DOM anche quando uno script viene caricato troppo tardi per ricevere DOMContentLoaded.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
document.readyStateDocument.readyState, letto come document.readyState, descrive lo stato di caricamento corrente del documento. È un’API Web del browser, non una funzionalità del linguaggio ECMAScript. MDN la classifica come ampiamente disponibile nei browser da luglio 2015; la sola versione di Node.js non dimostra che questa API sia supportata.
Il valore "loading" significa che il parser HTML è ancora al lavoro. In "interactive", il documento è già stato analizzato, ma le risorse dipendenti potrebbero essere ancora in caricamento. Il documento raggiunge lo stato "complete" quando è stato caricato e nessuna risorsa ritarda più l’evento load. L’evento load viene generato dopo il passaggio a questo stato. Le immagini con loading="lazy" potrebbero non essere ancora state caricate, perché non ritardano quell’evento. Un cambiamento di stato genera readystatechange sul documento.
Lo stato "interactive" non significa che DOMContentLoaded sia già stato generato: gli script classici con defer e gli script di modulo da eseguire dopo l’analisi del documento potrebbero essere ancora in attesa di esecuzione. Prima di generare l’evento, il browser esegue quegli script classici e avvia la valutazione di quei moduli. Non attende che termini la valutazione di un modulo sospeso su un await a livello superiore, né attende gli script di modulo con async o le immagini. Il fatto che il DOM sia pronto, quindi, non significa che la pagina sia stata caricata completamente.
L’esempio attende DOMContentLoaded solo quando lo stato è "loading"; negli altri casi chiama subito init(). In questo modo, uno script eseguito in ritardo non aspetta un evento che si è già verificato. Questo schema consente di accedere al DOM analizzato, ma non garantisce che altri script defer o di modulo abbiano terminato. { once: true } rimuove il listener dopo la prima chiamata.
Esempi
(() => {
function init() {
console.log("DOM parsed");
}
if (document.readyState === "loading") {
document.addEventListener("DOMContentLoaded", init, { once: true });
} else {
init();
}
})();Risultato
DOM parsed
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.