JavaScript свойство Node.childNodes

Определение и применение

JavaScript свойство childNodes объекта Node возвращает коллекцию всех дочерних узлов необходимого узла в виде объекта NodeList. Свойство доступно только для чтения.

Для того, чтобы определить количество дочерних узлов коллекции (объекта NodeList) используйте свойство length. Первый элемент коллекции NodeList будет соответствовать значению свойства firstChild, а последний значению lastChild.

Для того, чтобы получить коллекцию, которая содержит только элементы, то используйте свойство children объекта ParentNode. Коллекция childNodes живая: она автоматически обновляется при добавлении и удалении дочерних узлов.

Поддержка браузерами

Спецификация: dom.spec.whatwg

Поддерживается во всех основных браузерах с 2015 года.

Показать браузеры
Совместимостьapi.Node.childNodes
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
childNodes✓1✓12✓1✓7✓1.2✓18✓4✓10.1✓1✓1.0✓4.4✓1

поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31

JavaScript синтаксис

JavaScript
const nodes = node.childNodes;

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

DOM Standard.

Пример использования

Типы дочерних узлов блока

Нажмите ▶, затем Show types: под кнопкой появятся типы всех дочерних узлов блока — текстовые узлы (3), комментарий (8) и элемент (1). Удалите пробелы и комментарий в index.html и сравните.

index.html
HTML
<button data-migration-click-0="">Show types</button>
<div id="block">
  <!-- my comment -->
  <ul>
    <li>list item</li>
    <li>list item</li>
    <li>list item</li>
  </ul>
</div>
<p id="result"></p>
main.js
JavaScript
function myFunc() {
    const parentElem = document.getElementById('block'),
        parentElemChildNodes = parentElem.childNodes,
        result = document.getElementById('result')

    for (let i = 0; i < parentElemChildNodes.length; i++) {
        result.innerHTML += parentElemChildNodes[i].nodeType + '<br>'
    }
}

// Обработчики кнопок перенесены из HTML для запуска с CSP без inline-скриптов.
document.querySelector('[data-migration-click-0]').addEventListener('click', function () {
    myFunc()
})
document.querySelector('[data-migration-click-0]').removeAttribute('data-migration-click-0')

В этом примере с использованием метода addEventListener() при нажатии на кнопку (HTML элемент <button>) вызываем функцию, которая:

  • Инициализирует три переменные, которые содержат ссылку на элемент, значения типов дочерних узлов которого мы будем выводить, коллекцию всех дочерних узлов этого элемента (используем для этого свойство childNodes) и ссылку на элемент в который мы будем выводить результат.
  • С помощью цикла мы проходим по всей коллекции узлов и добавляем в элемент <p> числовое значение, определяющее тип текущего узла коллекции и тег переноса строки (<br>).

В результате чего мы получили следующие значения:

  • 3 - (текстовый узел - пробел перед узлом комментария).
  • 8 - (узел комментария).
  • 3 - (текстовый узел - пробел после узла комментария).
  • 1 - (узел элемента - элемент <ul>).
  • 3 - (текстовый узел - пробел после элемента <ul>).