WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Die Ereignisse DOMContentLoaded und pagehide

Mit `DOMContentLoaded` initialisierst du Code nach dem Aufbau des DOM. Mit `pagehide` pausierst du Arbeit beim Verlassen des Dokuments. Eine Wiederherstellung aus dem bfcache ist kein neuer Ladevorgang.

Version: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

document.addEventListener("DOMContentLoaded", onReady, { once: true });
window.addEventListener("pagehide", onPageHide);
window.addEventListener("pageshow", onPageShow);

DOMContentLoaded ist ein Event auf document. Der Browser löst es aus, nachdem er das HTML geparst, die klassischen Skripte mit defer ausgeführt und die Auswertung der für das Ende des Parsens vorgesehenen Modulskripte ohne async angestoßen hat. Er wartet nicht, bis die Modulauswertung abgeschlossen ist: Hält eine Abhängigkeit bei einem await auf oberster Ebene an, kann das Ereignis eintreten, noch bevor der Code des importierenden Moduls ausgeführt wird. Es wartet nicht auf Bilder, Frames oder den Abschluss von async-Skripten. Stylesheets können es indirekt verzögern, indem sie die Skriptausführung blockieren. Verwende load auf window, wenn du auf Ressourcen warten musst, die das Laden der Seite verzögern.

Kann der Initialisierungscode spät starten, prüfe document.readyState: Bei "loading" registrierst du einen einmaligen Listener für DOMContentLoaded, sonst nutzt du das bereits verfügbare DOM. "interactive" bedeutet, dass das Parsen abgeschlossen ist, nicht aber, dass das Ereignis bereits ausgelöst wurde oder andere Skripte mit ihrer Initialisierung fertig sind. Wenn du davon abhängst, lege die Reihenfolge der Initialisierung ausdrücklich fest.

Registriere pagehide auf window, um auf das Verlassen des Dokuments zu reagieren, etwa beim Zurücknavigieren. Dieses PageTransitionEvent meldet keinen bloßen Tabwechsel und kann die Navigation nicht abbrechen. event.persisted === true bedeutet, dass das Dokument im Vor-/Zurück-Cache (bfcache) erhalten bleiben kann, nicht dass seine Wiederherstellung garantiert ist. false bedeutet, dass es bei dieser Navigation nicht erhalten bleibt. Pausiere Arbeit bei pagehide und setze sie bei pageshow mit persisted === true fort: Ein wiederhergestelltes Dokument behält sein DOM und löst DOMContentLoaded nicht erneut aus.

Speichere wichtige Daten laufend. pagehide kann ausbleiben, vor allem wenn ein mobiler Browser zwangsweise geschlossen wird, und dort begonnene asynchrone Arbeit wird möglicherweise nicht abgeschlossen. Reagiere auf das Ausblenden der Seite mit visibilitychange auf document und prüfe auf "hidden". Das sind APIs der Webplattform und keine Neuerungen von ECMAScript 2024.

Beispiele

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>DOMContentLoaded and pagehide</title>
  <script>
    (() => {
      const init = () => console.log("DOM ready");

      if (document.readyState === "loading") {
        document.addEventListener("DOMContentLoaded", init, { once: true });
      } else {
        init();
      }

      window.addEventListener("pagehide", (event) => {
        console.log(`pagehide persisted=${event.persisted}`);
      });

      window.addEventListener("pageshow", (event) => {
        if (event.persisted) console.log("pageshow restored");
      });
    })();
  </script>
</head>
<body>
  <p>Open the browser console to see the event log.</p>
</body>
</html>

Ergebnis

DOM ready

Speichere das Beispiel als HTML-Datei und öffne sie im Browser. Aktiviere in der Konsole die Option zum Beibehalten des Protokolls und lade die Seite neu. `DOM ready` erscheint, sobald `DOMContentLoaded` ausgelöst wird. Weitere Meldungen hängen von der Navigation und davon ab, ob der Browser das Dokument behält.

Zugehörige Lektionen

  • JavaScript · Lektion 40 · Fortgeschritten · Version: 4
  • JavaScript · Lektion 41 · Fortgeschritten · Version: 4

Quellen