W3cubDocs

/Web APIs

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

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 ≤12.1 1 4.4 18 4 ≤12.1 1 1.0

© 2005–2023 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