HTMLCollection.item

The HTMLCollection method item() returns the node located at the specified offset into the collection.

Note: Because the contents of an HTMLCollection are live, changes to the underlying DOM can and will cause the position of individual nodes in the collection to change, so the index value will not necessarily remain constant for a given node.

Syntax

var element = HTMLCollection.item(index)

Parameters

index
The position of the Node to be returned. Elements appear in an HTMLCollection in the same order in which they appear in the document's source.

Return value

The Node at the specified index, or null if index is less than zero or greater than or equal to the length property.

Usage notes

The item() method returns a numbered element from an HTMLCollection. In JavaScript, it is easier to treat the HTMLCollection as an array and to index it using array notation. See the example below.

Example

var c = document.images;  // This is an HTMLCollection
var img0 = c.item(0);     // You can use the item() method this way
var img1 = c[1];          // But this notation is easier and more common

Browser compatibility

DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
itemChrome Full support YesEdge Full support 12Firefox Full support YesIE ? Opera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesFirefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yes

Legend

Full support
Full support
Compatibility unknown
Compatibility unknown

See also