WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Document.documentElement — das Wurzelelement des Dokuments

Document.documentElement gibt das Wurzelelement des Dokuments oder null zurück. Die Eigenschaft ist schreibgeschützt, das Element selbst kann jedoch geändert werden.

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

Lies Document.documentElement über eine Document-Instanz aus, zum Beispiel mit document.documentElement. Die Eigenschaft gibt das Element zurück, dessen Elternknoten das Dokument ist, oder null, wenn kein solches Element vorhanden ist. Ein Dokument kann höchstens ein solches Element haben.

Der HTML-Parser erzeugt normalerweise ein html-Element als Wurzelelement des Dokuments, aber das DOM schreibt diesen Tag-Namen nicht vor. Wenn du das Wurzelelement durch ein anderes Element ersetzt, etwa durch body, gibt die Eigenschaft das neue Element zurück. In XML hängt der Name vom Dokument ab. Verwechsle diese Eigenschaft nicht mit firstChild, das stattdessen beispielsweise auf eine Dokumenttypdeklaration verweisen kann.

Schreibgeschützt bedeutet nicht, dass das zurückgegebene Element unveränderlich ist. Das Beispiel entfernt die Wurzel eines separaten XML-Dokuments; beim nächsten Auslesen wird null zurückgegeben. Dies ist eine DOM-API, kein Sprachmerkmal von ECMAScript.

Beispiele

const doc = document.implementation.createDocument(null, "root");
console.log(doc.documentElement.localName);
doc.documentElement.remove();
console.log(doc.documentElement);

Ergebnis

root
null

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