This page was translated from English by the community. Learn more and join the MDN Web Docs community.

View in English Always switch to English

Document.documentElement

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨июль 2015 г.⁩.

Document.documentElement - свойство только для чтения, которое возвращает элемент Element , который является коренным элементом документа document (например элемент <html> для HTML документов).

Синтаксис

var element = document.documentElement;

Пример

js
var rootElement = document.documentElement;
var firstTier = rootElement.childNodes;

// firstTier -переменная объекта NodeList непосредственных потомков корневого элемента
for (var i = 0; i < firstTier.length; i++) {
  // что-то делает с каждым прямым потомком корневого элемента
  // как и firstTier[i]
}

Примечания

Это свойство удобно только для чтения для получения корневого элемента, связанного с любым документом.

HTML документ обычно содержит один дочерний узел - <html>, возможно с объявлением DOCTYPE перед ним. XML документы часто содержат множественные дочерние узлы: корневой элемент, объявление DOCTYPE, и инструкции по обработке.

Поэтому вам стоит использовать document.documentElement вместо document.firstChild для доступа к корневому элементу.

Спецификации

Specification
DOM
# ref-for-dom-document-documentelement①

Совместимость с браузерами