HTMLAllCollection: item() method

{{APIRef("HTML DOM")}}

The item() method of the {{domxref("HTMLAllCollection")}} interface returns the element located at the specified offset into the collection, or the element with the specified value for its id or name attribute.

Syntax

item(nameOrIndex)

Parameters

• nameOrIndex
  • : If this parameter is an integer, or a string that can be converted to an integer, then it represents the position of the {{domxref("Element")}} to be returned. Elements appear in an HTMLAllCollection in the same order in which they appear in the document's source. If the parameter is a string can't be converted to an integer, it will be interpreted as the name or id of the element to be returned.

Return value

If nameOrIndex represents an index, item() returns the {{domxref("Element")}} at the specified index, or null if nameOrIndex is less than zero or greater than or equal to the length property. If nameOrIndex represents a name, item() returns the same value as {{domxref("HTMLAllCollection/namedItem", "namedItem()")}}.

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

• {{domxref("HTMLCollection.item()")}}