Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Document.documentElement — element główny dokumentu

Document.documentElement zwraca element główny dokumentu albo null. Właściwość jest tylko do odczytu, lecz sam element można modyfikować.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

document.documentElement

Document.documentElement odczytuje się z instancji Document, np. jako document.documentElement. Zwraca Element, którego rodzicem jest dokument, albo null, gdy taki element nie istnieje. Dokument może mieć najwyżej jeden taki element.

Parser HTML zwykle tworzy element html jako element główny dokumentu, ale DOM nie wymaga takiej nazwy znacznika. Jeśli zastąpisz element główny innym elementem, na przykład body, właściwość zwróci ten nowy element. W XML nazwa zależy od dokumentu. Nie należy mylić tej właściwości z firstChild, który może wskazywać np. deklarację typu dokumentu.

Właściwość jest tylko do odczytu; nie oznacza to niezmienności zwróconego elementu. Przykład usuwa korzeń osobnego dokumentu XML, po czym kolejny odczyt zwraca null. To API DOM, nie funkcja samego ECMAScript.

Przykłady

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

Wynik

root
null

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła