NodeList.item()
Returns a node from a NodeList
by index. This method
doesn't throw exceptions as long as you provide arguments. A value of null
is returned if the index is out of range, and a TypeError
is thrown if no
argument is provided.
Syntax
nodeItem = nodeList.item(index)
-
nodeList
is aNodeList
. This is usually obtained from another DOM property or method, such as childNodes. index
is the index of the node to be fetched. The index is zero-based.-
nodeItem
is theindex
th node in thenodeList
returned by theitem
method.
Alternate Syntax
JavaScript also offers an array-like bracketed syntax for obtaining an item from a NodeList by index:
nodeItem = nodeList[index]
Example
var tables = document.getElementsByTagName("table");
var firstTable = tables.item(1); // or tables[1] - returns the second table in the DOM
Specifications
Specification |
---|
DOM Standard # ref-for-dom-nodelist-item① |
Browser compatibility
BCD tables only load in the browser