Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

DOMContentLoaded — disponibilité de l’arbre DOM

DOMContentLoaded signale la fin de l’analyse du HTML et de l’exécution des scripts différés. Il permet d’initialiser une interface sans attendre le chargement complet de la page.

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.addEventListener("DOMContentLoaded", init, { once: true });

DOMContentLoaded est un événement déclenché sur document après l’analyse du HTML et l’exécution des scripts différés. Il relève du standard HTML, et non d’ECMAScript ; les moteurs de navigateur actuels le prennent en charge. La seule présence de Node 24 ne fournit pas le document du navigateur.

Cet événement ne signifie pas que toutes les ressources sont chargées : il n’attend ni les images ni les scripts async. L’événement ultérieur load sur window correspond à une étape de chargement plus complète. Les feuilles de style peuvent retarder indirectement DOMContentLoaded en bloquant l’exécution des scripts différés.

Un écouteur ajouté après l’événement ne s’exécute pas rétroactivement. L’exemple vérifie donc document.readyState : si sa valeur est "loading", il enregistre init ; sinon, il l’appelle immédiatement. L’état "interactive" signifie que l’analyse est terminée, mais ne prouve pas que DOMContentLoaded a déjà été déclenché. Ce modèle gère la disponibilité du DOM ; il ne garantit pas l’attente des scripts différés restants.

Dans l’exemple, le script précède le paragraphe. L’attente évite de rechercher l’élément trop tôt ; après l’initialisation, le paragraphe et la console affichent DOM ready.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>DOMContentLoaded example</title>
  <script>
    function init() {
      document.getElementById("status").textContent = "DOM ready";
      console.log("DOM ready");
    }

    if (document.readyState === "loading") {
      document.addEventListener("DOMContentLoaded", init, { once: true });
    } else {
      init();
    }
  </script>
</head>
<body>
  <p id="status">Waiting</p>
</body>
</html>

Résultat

DOM ready

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.

Sources