---
title: "`HTMLCollection` и `NodeList`"
description: "Коллекции элементов DOM-дерева. Похожие, но отличающиеся."
url: "https://doka.guide/js/htmlcollection-and-nodelist/"
section: "JavaScript"
createdAt: "2021-07-02"
updatedAt: "2026-11-20"
baseline: [{"group":"dom","features":["api.HTMLCollection","api.NodeList"]}]
authors: ["nlopin"]
contributors: ["northrain-cmd", "rakleed"]
related: ["tools/how-the-browser-creates-pages", "js/query-selector-all", "js/getelementsbyclassname"]
source: "https://github.com/doka-guide/content/blob/main/js/htmlcollection-and-nodelist/index.md"
license: "CC BY-NC-SA 4.0"
---

# `HTMLCollection` и `NodeList`

## Кратко

`HTMLCollection` и `NodeList` — это очень похожие на массив коллекции. Они хранят элементы веб-страницы (узлы [DOM](/js/dom/)). `NodeList` может хранить любые типы узлов, а `HTMLCollection` — только узлы HTML-элементов. К элементам коллекций можно обращаться по индексу, но у них нет привычных [методов массива](/js/arrays/).

`HTMLCollection` возвращает методы [`getElementsByTagName()`](/js/getelementsbytagname/) и [`getElementsByClassName()`](/js/getelementsbyclassname/).

`NodeList` возвращает метод [`querySelectorAll()`](/js/query-selector-all/) и свойство `childNodes`.

Полный список всех методов, возвращающих типы `NodeList` или `HTMLCollection`, найдёте в [стандарте DOM](https://dom.spec.whatwg.org/#document).

## Как понять

`HTMLCollection` возвращают методы, которые работают с DOM — представлением HTML-кода страницы в JavaScript.

Полученная один раз коллекция всегда остаётся актуальной. JavaScript будет обновлять её в случае, если на странице появляется подходящий элемент. Поэтому `HTMLCollection` называют «живой» коллекцией.

Например, единожды получив коллекцию, можем не заботиться о её поддержке:

<iframe title="Демонстрация работы" src="https://doka.guide/js/htmlcollection-and-nodelist/demos/htmlcollection-example/" height="450"></iframe>

`NodeList` работает почти так же, как и `HTMLCollection`.

Разница:

1. `NodeList` хранит любые типы узлов, например, текстовые узлы и комментарии, а `HTMLCollection` — только узлы HTML-элементов.
1. `HTMLCollection` позволяет обращаться к элементам не только по индексу, но и по имени, с помощью метода `namedItem`.
1. `NodeList` может быть не только «живой» коллекцией, но и статической. Такая коллекция не обновляется при появлении на странице новых элементов.

«Живой» `NodeList` возвращают метод `getElementsByName()` и свойство `childNodes`.

Статический `NodeList` возвращает метод `querySelectorAll()`.

## На практике: Николай Лопин

🛠 Используйте индексы для получения отдельных элементов коллекции:

```js
const paragraphs = document.getElementsByTagName('p')
console.log(paragraphs[0])
```

🛠 Если нужно обойти все элементы в цикле, можно написать классический цикл [`for`](/js/for/):

```js
const paragraphs = document.getElementsByTagName('p')
for (let i = 0; i < paragraphs.length; ++i) {
  console.log(paragraphs[i].id)
  // Печатаем значение атрибута id элемента
}
```

Другой вариант — воспользоваться синтаксисом `for..of`:

```js
const paragraphs = document.getElementsByTagName('p')
for (let item of paragraphs) {
  console.log(item.id)
}
```

🛠 При создании цикла над `HTMLCollection` убедитесь, что подходящие элементы не добавляются или удаляются со страницы в момент работы цикла. Так как коллекция живая, её обновление в этот момент приведёт к бесконечному циклу.

🛠 Если нужны методы массива, преобразуйте `HTMLCollection` или `NodeList` в массив с помощью [`Array.from()`](/js/array-from/).

```js
const paragraphs = document.getElementsByTagName('p')
let array = Array.from(paragraphs)

console.log(array.pop())
```

