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 Standard
# ref-for-dom-nodelist-item①

Browser compatibility

BCD tables only load in the browser