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