NodeList: item() method
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.
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.
In JavaScript, instead of calling nodeList.item(index)
, you can also access the index
directly, like nodeList[index]
.
Syntax
js
item(index)
Parameters
index
-
The index of the node to be fetched. The index is zero-based.
Return value
The index
th node in the nodeList
returned by the item
method.
Exceptions
TypeError
-
Thrown if no argument is provided.
Examples
js
const tables = document.getElementsByTagName("table");
const 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