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 (DOM) # ref-for-dom-nodelist-item① |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
item |
1 |
12 |
1 |
5 |
Yes |
1 |
Yes |
Yes |
4 |
Yes |
1 |
Yes |
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/NodeList/item