KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

DOMContentLoaded — gereedheid van de DOM-boom

DOMContentLoaded geeft aan dat het parsen van HTML en het uitvoeren van uitgestelde scripts is voltooid. Hiermee kun je een interface initialiseren zonder te wachten tot de hele pagina is geladen.

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

DOMContentLoaded is een gebeurtenis die op document wordt geactiveerd nadat het parsen van HTML en het uitvoeren van uitgestelde scripts zijn voltooid. De gebeurtenis hoort bij de HTML-standaard, niet bij ECMAScript; huidige browser-engines ondersteunen deze. Met alleen Node 24 heb je geen toegang tot het document van een browser.

De gebeurtenis betekent niet dat alle bronnen zijn geladen: er wordt niet gewacht op afbeeldingen of async-scripts. De latere gebeurtenis load op window duidt op een verder gevorderde laadfase. Stylesheets kunnen DOMContentLoaded indirect vertragen doordat ze de uitvoering van uitgestelde scripts blokkeren.

Een listener die na de gebeurtenis wordt toegevoegd, wordt niet alsnog uitgevoerd. Daarom controleert het voorbeeld document.readyState: bij de waarde "loading" registreert het init; anders roept het die meteen aan. De status "interactive" betekent dat het parsen is voltooid, maar bewijst niet dat DOMContentLoaded al is geactiveerd. Dit patroon regelt de gereedheid van de DOM; het garandeert niet dat er wordt gewacht op resterende uitgestelde scripts.

Het script in het voorbeeld staat vóór de alinea. Door te wachten voorkom je dat het element te vroeg wordt opgezocht; na de initialisatie tonen zowel de alinea als de console DOM ready.

Voorbeelden

<!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>

Resultaat

DOM ready

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.

Bronnen