CKTIS / JavaScript
Elemente per ID finden und den Ladezustand prüfen
`getElementById()` prüft, ob ein Element gerade im Dokumentbaum steht. `readyState` meldet dagegen eine Ladephase, nicht die Existenz eines bestimmten Elements.
Version: Current web platform; runtime support varies
Syntax
document.getElementById(id); // Element | null
document.readyState; // "loading" | "interactive" | "complete"document.getElementById(id) durchsucht den aktuellen Baum dieses Dokuments. Gib den exakten Wert von id mit passender Groß- und Kleinschreibung an, ohne das # eines CSS-Selektors voranzustellen. Die Methode gibt ein Element oder null zurück. Bei doppelten IDs liefert sie den ersten Treffer in Baumreihenfolge; in einem HTML-Dokument sollten IDs jedoch eindeutig sein. Prüfe das Ergebnis: Ein Eigenschaftszugriff auf null löst einen TypeError aus.
document.readyState ist eine schreibgeschützte Eigenschaft, keine Methode. Beim normalen Laden einer Seite bedeutet "loading", dass der Parser noch arbeitet, und "interactive", dass er fertig ist. Bei "complete" sind die Ressourcen geladen, die das load-Ereignis des Fensters verzögern; dieses Ereignis folgt unmittelbar darauf. Ein Zustandswechsel löst am Dokument readystatechange aus. DOMContentLoaded wird nach dem Wechsel zu "interactive" ausgelöst, nachdem die klassischen Skripte mit defer gelaufen sind und der Browser die Ausführung der für die Zeit nach dem Parsen vorgesehenen Modulskripte ohne async angestoßen hat. Das Ereignis garantiert nicht, dass Code nach einem await auf oberster Modulebene bereits ausgeführt wurde. Auf Bilder wartet das Ereignis nicht direkt.
Wenn die Initialisierung nur das geparste DOM braucht, registriere bei document.readyState === "loading" am Dokument einen Listener für DOMContentLoaded mit { once: true }; andernfalls starte sofort. "interactive" garantiert nicht, dass DOMContentLoaded bereits ausgelöst wurde. Auch bei "complete" kann die Suche null liefern, etwa wenn die Anwendung das Element erst später einfügt. Der DOM-Standard definiert getElementById(), der HTML-Standard definiert readyState. Beide gehören zu den Web-APIs, nicht zu ECMAScript; eine Laufzeitumgebung ohne Browser-DOM stellt sie möglicherweise nicht bereit.
Beispiele
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Document readiness and ID lookup</title>
</head>
<body>
<script>
const doc = document.implementation.createHTMLDocument();
const item = doc.createElement("p");
item.id = "status";
console.log(doc.readyState);
console.log(doc.getElementById("status") === null);
doc.body.append(item);
console.log(doc.getElementById("status") === item);
console.log(doc.getElementById("Status") === null);
</script>
</body>
</html>Ergebnis
complete true true true
Speichere das Beispiel als HTML-Datei, öffne sie im Browser und prüfe die Ausgabe in der Browserkonsole. Das neue Dokument hat bereits den Zustand `complete`, aber die Suche findet `status` erst nach dem Einfügen. `Status` stimmt weiterhin nicht überein.
Zugehörige Lektionen
- JavaScript · Lektion 39 · Mittlere Stufe · Version: 3