JavaScript: The Definitive Guide, Fourth Edition

Name

Document.getElementsByTagNameNS( ) — return all Element nodes with a specified name and namespace

Availability

DOM Level 2 Core

Synopsis

Node[] getElementsByTagNameNS(String namespaceURI, 
                              String localName);

Arguments

namespaceURI

The unique identifier of the namespace of the desired elements, or “*” to match all namespaces.

localName

The local name of the desired elements, or “*” to match any local name.

Returns

A read-only array (technically, a NodeList) of all Element nodes in the document tree that have the specified namespace and local name.

Description

This method works just like getElementsByTagName( ) except that it searches for elements by namespace and name. It is useful only with XML documents that use namespaces.