NodeList: item() method

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

js

item(index)

JavaScript also offers an array-like bracketed syntax for obtaining an item from a NodeList by index:

js

nodeItem = nodeList[index];

Parameters

  • index is 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