element.getElementsByTagName

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Resumen

Devuelve una lista de elementos que tienen un tag name determinado. Se explora el árbol por debajo del elemento dado, excluyendo el propio elemento.

Sintaxis

js
elements = element.getElementsByTagName(tagName);
  • elements es un NodeList del elemento encontrado en el orden en que aparece en el árbol.
  • element es el elemento a partir del cual debe empezar la búsqueda. Recuerda que sólo se buscan los elementos descendentes del elemento dado, sin incluir el propio elemento.
  • tagName es el nombre que se busca. La cadena especial "*" representa todos los elementos.

Nota: En Firefox 2 (Gecko 1.8.1) y anteriores, este método no funcionaba correctamente si el árbol contenía algún elemento con etiqueta de nombre conteniendo espacios. (Ver Error 206053 en Firefox para más detalles).

Es recomendable usar DOM:document.getElementsByTagNameNS cuando se manejan documentos con "multi-namespace".

Ejemplo

js
// comprueba la alineación de las celdas en una tabla.
var table = document.getElementById("forecast-table");
var cells = table.getElementsByTagName("td");
for (var i = 0; i < cells.length; i++) {
  status = cells[i].getAttribute("status");
  if (status == "open") {
    // grab the data
  }
}

Notas

element.getElementsByTagName es similar a document.getElementsByTagName, excepto por que su búsqueda está restringida a los elementos que descienden del elemento especificado.

Especificaciones

Specification
DOM
# dom-element-getelementsbytagname

Compatibilidad con navegadores

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
getElementsByTagName
getElementsByTagName("*")

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
See implementation notes.