Что возвращает getElementsByTagName — один элемент или коллекцию?

Что возвращает getElementsByTagName?

Метод getElementsByTagName возвращает живую коллекцию элементов — HTMLCollection. Это не один элемент, а список всех элементов с указанным тегом в документе. Коллекция является живой, то есть автоматически обновляется при добавлении или удалении элементов из DOM.

Как работать с результатом?

Чтобы получить конкретный элемент, используйте индекс или метод item(). Например:

const divs = document.getElementsByTagName('div');
const firstDiv = divs[0]; // первый div
const secondDiv = divs.item(1); // второй div

Если нужно перебрать все элементы, используйте цикл for или преобразуйте в массив через Array.from().

Отличие от других методов

• getElementById — возвращает один элемент (или null).
• querySelector — возвращает первый подходящий элемент.
• querySelectorAll — возвращает статическую коллекцию NodeList (не живую).

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

// Получаем все параграфы
const paragraphs = document.getElementsByTagName('p');
console.log(paragraphs.length); // количество параграфов

// Добавляем новый параграф
const newP = document.createElement('p');
document.body.appendChild(newP);
console.log(paragraphs.length); // увеличится автоматически

Вывод: getElementsByTagName возвращает живую коллекцию HTMLCollection, что удобно для динамических страниц, где DOM часто меняется. Однако для статичных списков лучше использовать querySelectorAll, чтобы избежать неожиданных изменений.