CKTIS / JavaScript
Document.readyState — état de chargement du document
Document.readyState décrit l’étape de chargement du document : loading, interactive ou complete. Vérifier cette propriété aide à initialiser le code lié au DOM même si un script est chargé trop tard pour recevoir DOMContentLoaded.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
document.readyStateDocument.readyState, lu sous la forme document.readyState, décrit l’état de chargement actuel du document. Il s’agit d’une API Web du navigateur, et non d’une fonctionnalité du langage ECMAScript. MDN la classe comme largement disponible dans les navigateurs depuis juillet 2015 ; la version de Node.js, à elle seule, ne permet pas d’établir que cette API est prise en charge.
La valeur "loading" signifie que le parseur HTML travaille encore. À l’état "interactive", le document a été analysé, mais des ressources associées peuvent encore être en cours de chargement. Le document atteint l’état "complete" lorsque son chargement est terminé et qu’aucune ressource ne retarde plus l’événement load. L’événement load se déclenche après ce changement d’état. Les images avec loading="lazy" peuvent ne pas encore être chargées, car elles ne retardent pas cet événement. Un changement d’état déclenche readystatechange sur le document.
L’état "interactive" ne signifie pas que DOMContentLoaded s’est déjà déclenché : les scripts classiques avec defer et les scripts de module dont l’exécution est prévue après l’analyse du document peuvent encore être en attente. Avant de déclencher l’événement, le navigateur exécute ces scripts classiques et lance l’évaluation de ces modules. Il n’attend ni la fin de l’évaluation d’un module suspendu par un await au niveau supérieur, ni les scripts de module avec async, ni les images. Le DOM peut donc être prêt sans que la page soit entièrement chargée.
L’exemple attend DOMContentLoaded uniquement lorsque l’état est "loading" ; sinon, il appelle init() immédiatement. Ainsi, un script exécuté tardivement n’attend pas un événement qui a déjà eu lieu. Ce modèle permet d’accéder au DOM analysé, mais ne garantit pas que les autres scripts defer ou de module ont terminé. { once: true } supprime l’écouteur après son premier appel.
Exemples
(() => {
function init() {
console.log("DOM parsed");
}
if (document.readyState === "loading") {
document.addEventListener("DOMContentLoaded", init, { once: true });
} else {
init();
}
})();Résultat
DOM parsed
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.