Start · Sprachen · JavaScript · Referenz · Document.body

Document.body

Eigenschaft

Die Eigenschaft <code>Document.body</code> repräsentiert den <code>&lt;body&gt;</code>- oder <code>&lt;frameset&gt;</code>-Knoten des aktuellen Dokuments.

Kategorie: web-api

Signatur

Document.body

Beschreibung

Die Eigenschaft Document.body repräsentiert den <body>- oder <frameset>-Knoten des aktuellen Dokuments oder null, wenn kein solches Element existiert.

Rückgabewert

Typ
HTMLBodyElement | HTMLFrameSetElement | null
Beschreibung
Eines der Folgenden: HTMLBodyElement, HTMLFrameSetElement oder null.

Beispiele

Beispiel

// Given this HTML: <body id="oldBodyElement"></body>
alert(document.body.id); // "oldBodyElement"

const newBodyElement = document.createElement("body");

newBodyElement.id = "newBodyElement";
document.body = newBodyElement;
alert(document.body.id); // "newBodyElement"

// Wichtig · Fallstricke

document.body ist das Element, das den Inhalt des Dokuments enthält. In Dokumenten mit <body>-Inhalten wird das <body>-Element zurückgegeben, und in Frameset-Dokumenten wird das äußerste <frameset>-Element zurückgegeben.

Obwohl die body-Eigenschaft setzbar ist, führt das Setzen eines neuen body auf einem Dokument effektiv dazu, dass alle aktuellen Kinder des existierenden <body>-Elements entfernt werden.

Siehe auch