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 indexth 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 # ref-for-dom-nodelist-item① |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
item
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support