Element.getElementsByTagNameNS()

El método Element.getElementsByTagNameNS() devuelve una HTMLCollection viva de elementos con el nombre de etiqueta dado perteneciente al espacio de nombres dado. Es similar a Document.getElementsByTagNameNS, con la excepción de que su búsqueda está limitada a los descendientes del elemento especificado.

elementos = elemento.getElementsByTagNameNS(espacioNombreURI, nombreLocal)

• elementos es una HTMLCollection viva de elementos encontrados en el orden en el que aparecen en el árbol.
• elemento es el elemento desde el cual la búsqueda debería comenzar. Nótese que sólo los descendientes de este elemento están incluídos en la búsqueda, no el nodo en sí.
• espacioNombreURI es el URI del espacio de nombres de los elementos a buscar (vea Node.namespaceURI). Por ejemplo, si usted necesita buscar elementos XHTML, use el URI de espacio de nombres de XHTML, http://www.w3.org/1999/xhtml.
• nombreLocal puede ser el nombre local de los elementos a buscar o el valor especial "*", que encuentra todos los elementos (vea Node.localName).

// verifica la alineación en un número de celdas en una tabla en un documento XHTML.
var table = document.getElementById("forecast-table");
var cells = table.getElementsByTagNameNS("http://www.w3.org/1999/xhtml", "td");

for (var i = 0; i < cells.length; i++) {
    var axis = cells[i].getAttribute("axis");
    if (axis == "year") {
        // obtiene los datos
    }
}

[1] Inicialmente, este método devolvía una NodeList; luego fue modificado para reflejar el cambio en la especificación.

[2] El comportamiento de element.getElementsByTagNameNS cambió entre Firefox 3.5 y Firefox 3.6. En Firefox 3.5 y anteriores, esta función automáticamente convertía mayúsculas o minúsculas en las consultas, de manera que una búsqueda de "foo" encontraría "Foo" o "foo". En Firefox 3.6 y posteriores esta función es sensible a mayúsculas y minúsculas, por lo que una consulta por "foo" sólo encontrará "foo" y no "Foo". Para más información al respecto, por favor vea el comentario de Henri Sivonen sobre este cambio. También puede ver la parte relevante del estándar, que establece qué partes de la API son sensibles a mayúsculas y minúsculas y qué partes no.

Previo a Firefox 19, este método devolvía una NodeList; luego fue modificado para reflejar el cambio en la especificación.