CKTIS / JavaScript
Document — Zugriff auf das Dokument einer Seite
Document steht für ein DOM-Dokument. Mit dem Objekt document lassen sich Elemente suchen, die Dokumentwurzel auslesen und Seiteneigenschaften zu Titel, Fokus und Sichtbarkeit verwenden. Es ist eine Schnittstelle der Webplattform und kein Bestandteil von ECMAScript selbst.
Version: 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.getElementById(id)
document.documentElement
document.body
document.title
document.activeElement
document.hidden
document.addEventListener("visibilitychange", handler)Document steht für ein DOM-Dokument; in einem Seitenskript verweist document auf das aktuelle Dokument. Es ist weder window noch das Wurzelelement. Dies ist eine Schnittstelle der Webplattform: Die Verfügbarkeit von JavaScript allein, auch in Node 24, belegt nicht, dass sie unterstützt wird.
Document.getElementById(id) gibt das erste passende Element in Baumreihenfolge oder null zurück. Übergib die Kennung ohne # und prüfe das Ergebnis, bevor du es verwendest. Document.documentElement bezeichnet das Wurzelelement oder ist null. Auf einer typischen HTML-Seite ist dies das Element html. Document.body stellt das Element body oder frameset bereit, kann aber null sein, etwa bevor der Parser es erstellt. Mit Document.title kannst du den Dokumenttitel lesen oder ändern.
Document.activeElement bezeichnet das Element, das mit dem Fokus verbunden ist; es muss kein Texteingabefeld sein. Liegt der Fokus in einem eingebetteten Dokument oder Shadow-Tree, kann es statt des tiefsten Elements jeweils das einbettende Element oder den Host bezeichnen. Document.hidden ist ein boolescher Wert, der angibt, ob das Dokument verborgen ist, nicht ob es den Fokus verloren hat. Document.visibilitychange bezeichnet das Ereignis visibilitychange, keine Methode: Behandle es mit document.addEventListener("visibilitychange", handler) und lies document.hidden im Handler aus.
Das Beispiel erstellt ein separates HTML-Dokument. Daher verändert es die geöffnete Seite nicht und liefert vorhersehbare Werte. Fokus oder Sichtbarkeit werden nicht getestet, da sie von der Umgebung abhängen. Die Quellenabdeckung ist begrenzt: Der angegebene DOM Standard definiert den Kern von Document, aber nicht alle aufgeführten HTML-Erweiterungen zu Titel, Body, Fokus und Sichtbarkeit. Mindestversionen von Browsern wurden hier nicht ermittelt.
Beispiele
const demo = document.implementation.createHTMLDocument("Document demo");
const item = demo.createElement("p");
item.id = "message";
item.textContent = "Hello, DOM";
demo.body.appendChild(item);
console.log(demo.documentElement.localName);
console.log(demo.body.localName);
console.log(demo.title);
console.log(demo.getElementById("message").textContent);
console.log(demo.getElementById("missing") === null);Ergebnis
html body Document demo Hello, DOM true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.