Элемент: метод getElementsByTagName()

Базовая линия Широко доступно

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

Метод Element.getElementsByTagName() возвращает живой HTMLCollection элементов с заданным именем тега.

Ищутся все потомки указанного элемента, но не сам элемент. Возвращаемый список является живым, что означает, что он автоматически обновляется вместе с деревом DOM. Поэтому нет необходимости вызывать Element.getElementsByTagName() с тем же элементом и аргументами повторно, если DOM изменяется между вызовами.

При вызове на HTML-элементе в HTML-документе getElementsByTagName преобразует аргумент в нижний регистр перед поиском. Это нежелательно при попытке сопоставить строчные SVG-элементы (такие как <linearGradient>) в HTML-документе. Вместо этого используйте Element.getElementsByTagNameNS(), который сохраняет регистр имени тега.

Element.getElementsByTagName аналогичен Document.getElementsByTagName(), за исключением того, что он ищет только элементы, являющиеся потомками указанного элемента.

Синтаксис

getElementsByTagName(tagName)

Параметры

tagName: Искомое имя тега. Специальная строка "*" представляет все элементы. Для совместимости с XHTML следует использовать строчные буквы.

Возвращаемое значение

Живой HTMLCollection элементов с совпадающим именем тега в порядке их появления. Если элементы не найдены, HTMLCollection пуста.

Примеры

// Check the status of each data cell in a table
const table = document.getElementById("forecast-table");
const cells = table.getElementsByTagName("td");

for (const cell of cells) {
  const status = cell.getAttribute("data-status");
  if (status === "open") {
    // Grab the data
  }
}

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

Спецификация
DOM # dom-element-getelementsbytagname

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

	Рабочий стол					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`getElementsByTagName`	1 Изначально этот метод возвращал `NodeList`; затем он был изменён для соответствия изменениям спецификации.	12	1 До Firefox 19 этот метод возвращал `NodeList`; затем он был изменён для соответствия изменениям спецификации.	8 Изначально этот метод возвращал `NodeList`; затем он был изменён для соответствия изменениям спецификации.	1 Изначально этот метод возвращал `NodeList`; затем он был изменён для соответствия изменениям спецификации.	18 Изначально этот метод возвращал `NodeList`; затем он был изменён для соответствия изменениям спецификации.	4 До Firefox for Android 19 этот метод возвращал `NodeList`; затем он был изменён для соответствия изменениям спецификации.	10.1	1 Изначально этот метод возвращал `NodeList`; затем он был изменён для соответствия изменениям спецификации.	1.0 Изначально этот метод возвращал `NodeList`; затем он был изменён для соответствия изменениям спецификации.	4.4 Изначально этот метод возвращал `NodeList`; затем он был изменён для соответствия изменениям спецификации.
`all_elements_selector`	1	12	1	≤15	1	18	4	≤14	1	1.0	4.4

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Element/getElementsByTagName