Document.readyState

Zusammenfassung

Die Eigenschaft Document.readyState eines document-Objektes beschreibt dessen Ladezustand.

Werte

Die Eigenschaft readyState kann folgende Werte haben:

loading: Das Dokument wird noch geladen.
interactive: Das Dokument selbst wurde vollständig eingelesen und verarbeitet, aber das Laden weiterer Bestandteile wie Bilder, Stylesheets und Frames ist noch nicht abgeschlossen.
Dieser Status zeigt an, dass das Ereignis DOMContentLoaded (en-US) ausgelöst wurde.
complete: Das Dokument und seine Bestandteile wurden geladen.
Dieser Status zeigt an, dass das Ereignis load (en-US) ausgelöst wurde.

Ändert sich der Wert dieser Eigenschaft, wird das Ereignis readystatechange (en-US) des zugehörigen document-Objekts augelöst.

Syntax

var string = document.readyState;

Beispiele

Verschiedene Ladezustände

switch (document.readyState) {
  case "loading":
    // Das Dokument wird noch geladen.
    break;
  case "interactive":
    // Das Dokument wurde geladen. Wir können nun die DOM-Elemente ansprechen.
    var span = document.createElement("span");
    span.textContent = "A <span> element.";
    document.body.appendChild(span);
    break;
  case "complete":
    // Die Seite ist komplett geladen.
    console.log("The first CSS rule is: " + document.styleSheets[0].cssRules[0].cssText);
    break;
}

readystatechange als eine Alternative zum Ereignis DOMContentLoaded

// Alternative zum Ereignis DOMContentLoaded
document.onreadystatechange = function () {
  if (document.readyState == "interactive") {
    initApplication();
  }
}

readystatechange als eine Alternative zum Ereignis load

// Alternative zum Ereignis load
document.onreadystatechange = function () {
  if (document.readyState == "complete") {
    initApplication();
  }
}

Spezifikation

Spezifikation	Status	Kommentar
HTML Living Standard Die Definition von 'Document readiness' in dieser Spezifikation.	Lebender Standard
HTML 5.1 Die Definition von 'Document readiness' in dieser Spezifikation.	Empfehlung
HTML5 Die Definition von 'Document readiness' in dieser Spezifikation.	Empfehlung	Initiale Spezifikation.