HTMLCollection: 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.
The HTMLCollection method item()
returns the element 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
elements in the collection to change, so the index value will not necessarily remain
constant for a given element.
Syntax
item(index)
Parameters
Return value
The Element 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.
Examples
const images = document.images; // This is an HTMLCollection
const img0 = images.item(0); // You can use the item() method this way
const img1 = images[1]; // But this notation is easier and more common
Specifications
| Specification |
|---|
| DOM # ref-for-dom-htmlcollection-item① |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
item
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support