CKTIS / JavaScript
Document.body – Zugriff auf das Body-Element des Dokuments
Document.body ist eine Web-API-Eigenschaft und wird als document.body verwendet. Sie gibt ein body-Element, ein veraltetes frameset-Element oder null zurück. Eine Zuweisung ersetzt das gesamte Element, nicht nur seinen Inhalt.
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.body
document.body = newBodyDocument.body ist eine Eigenschaft der Schnittstelle Document und wird als document.body verwendet. Sie gibt das erste direkte Kindelement des Wurzelelements des Dokuments zurück, das ein body- oder frameset-Element im HTML-Namensraum ist. Gibt es kein solches Kindelement, gibt sie null zurück. Das Wurzelelement selbst muss kein html-Element sein. Die Eigenschaft liefert weder Text noch eine Kopie des Elements.
Berücksichtige vor der Verwendung, dass das Ergebnis null sein kann, zum Beispiel wenn der Parser das body-Element noch nicht erstellt hat. Dies ist eine im HTML Standard definierte Web-API und kein Bestandteil von ECMAScript selbst. Die Node-Version im Repository belegt nicht, dass diese Browser-API verfügbar ist.
Mit document.body = newBody wird das vorhandene Element samt Unterbaum ersetzt; der alte Inhalt wird nicht kopiert. Wird dasselbe Element zugewiesen, ändert sich nichts. Fehlt das Body-Element, wird das neue Element an das Wurzelelement angehängt. Ein fehlendes Wurzelelement sowie die Zuweisung von null oder eines div-Elements lösen eine HierarchyRequestError-DOMException aus: Akzeptiert werden body- und frameset-Elemente.
Das Beispiel arbeitet mit einem separaten Dokument. Es zeigt, wie das Element ersetzt und das vorherige abgetrennt wird, ohne die angezeigte Seite zu ändern.
Beispiele
const doc = document.implementation.createHTMLDocument("");
const original = doc.body;
original.textContent = "Before";
const replacement = doc.createElement("body");
replacement.textContent = "After";
doc.body = replacement;
console.log(doc.body === replacement);
console.log(doc.body.textContent);
console.log(original.parentNode === null);Ergebnis
true After 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.