CKTIS / JavaScript
`document.body` und `document.documentElement` im Vergleich
Mit `document.body` greifst du auf das Inhaltselement der Seite zu, mit `document.documentElement` auf das Wurzelelement des Dokuments. Beide Eigenschaften können `null` zurückgeben.
Version: Current web platform; runtime support varies
Syntax
document.body
document.documentElement
document.body = newBodydocument.documentElement gibt das Wurzelelement des Dokuments zurück oder null, wenn keines vorhanden ist. Auf einer normalen HTML-Seite ist das <html>; in einem XML-Dokument kann das Wurzelelement anders heißen. Die Eigenschaft ist schreibgeschützt, das zurückgegebene Element lässt sich aber ändern, etwa indem du sein Attribut lang setzt.
document.body gibt das erste direkte Kindelement des Wurzelelements <html> zurück, das ein <body> oder ein veraltetes <frameset> ist. Alle drei Namen beziehen sich auf Elemente im HTML-Namensraum. Fehlt ein passendes Kindelement oder ist die Wurzel kein HTML-Element <html>, lautet das Ergebnis null. Füge Seiteninhalte auf einer normalen HTML-Seite in <body> ein, nicht direkt in <html>.
Wenn du document.body ein neues Element zuweist, ersetzt du das vorhandene Element samt seinem Teilbaum, statt ihm Inhalt hinzuzufügen. Fehlt der Body, hängt der Setter das übergebene Element an das Wurzelelement an. Die Zuweisung von null oder eines anderen Elements als HTML-<body> oder HTML-<frameset> sowie ein Einfügeversuch ohne Wurzelelement lösen eine DOMException namens HierarchyRequestError aus.
Der HTML-Standard definiert document.body, der DOM-Standard definiert document.documentElement. Keine der beiden Eigenschaften gehört zu ECMAScript 2024. Eine Laufzeitumgebung ohne Seiten-DOM stellt möglicherweise kein globales document bereit. Ein Skript kann während des Parsens die Wurzel sehen, bevor <body> erzeugt wird. Prüfe vor der Verwendung auf null. Auf einer normalen Seite kannst du auf DOMContentLoaded warten, wenn das Parsen noch läuft.
Beispiele
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Document body and root</title>
</head>
<body>
<script>
{
const doc = document.implementation.createHTMLDocument();
const root = doc.documentElement;
const body = doc.body;
console.log(`${root.localName} > ${body.localName}`);
console.log(body.parentElement === root);
body.remove();
console.log(doc.body === null);
console.log(doc.documentElement === root);
}
</script>
</body>
</html>Ergebnis
html > body true true true
Speichere das Beispiel als HTML-Datei, öffne sie im Browser und sieh dir die Ausgabe in der Browserkonsole an. Das Skript erzeugt ein separates HTML-Dokument, gibt die Elementnamen aus und prüft die Eltern-Kind-Beziehung. Nach dem Entfernen von `<body>` gibt `doc.body` `null` zurück; die Wurzel ist weiterhin dasselbe Objekt. Die geöffnete Seite bleibt unverändert.
Zugehörige Lektionen
- JavaScript · Lektion 32 · Mittlere Stufe · Version: 3