DOMTokenList: item() method

The item() method of the DOMTokenList interface returns an item in the list, determined by its position in the list, its index.

Note: This method is equivalent as the bracket notation. So aList.item(i) is the same as aList[i].

Syntax

tokenList.item(index)

Parameters

index: A number representing the index of the item you want to return. If it isn't an integer, only the integer part is considered.

Return value

A string representing the returned item, or null if the number is greater than or equal to the length of the list.

Exceptions

TypeError: Thrown if the index cannot be converted to an integer.

In the following example we retrieve the list of classes set on a <span> element as a DOMTokenList using Element.classList. We then retrieve the last item in the list using item(tokenList.length - 1), and write it into the <span>'s Node.textContent.

First, the HTML:

html

<span class="a b c"></span>

Now the JavaScript:

const span = document.querySelector("span");
const classes = span.classList;
const item = classes.item(classes.length - 1);
span.textContent = item;

The output looks like this:

Specifications

Specification
DOM Standard # ref-for-dom-domtokenlist-item①

Browser compatibility

BCD tables only load in the browser