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
indexcannot be converted to an integer.
Examples
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:
<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