DOMTokenList: entries() method

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨October 2017⁩.

The entries() method of the DOMTokenList interface returns an iterator allowing you to go through all key/value pairs contained in this object. The values are Arrays which have [key, value] pairs, each representing a single token.

Syntax

js
entries()

Parameters

None.

Return value

Returns an iterator.

Examples

In the following example we retrieve the list of classes set on a <span> element as a DOMTokenList using Element.classList. We when retrieve an iterator containing the key/value pairs using entries(), then iterate through each one using a for...of loop, writing them to the <span>'s Node.textContent.

First, the HTML:

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

Now the JavaScript:

js
const span = document.querySelector("span");
const classes = span.classList;
const iterator = classes.entries();

for (const value of iterator) {
  span.textContent += `(${value})`;
}

The output looks like this:

Specifications

This feature does not appear to be defined in any specification.

Browser compatibility

See also