WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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 = newBody

Document.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.

Quellen