DOMTokenList.values()

The values() method of the DOMTokenList interface returns an iterator allowing developers to go through all values contained in the DOMTokenList. The individual values are DOMString objects.

Syntax

tokenList.values();

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 values using values(), then iterate through those values using a for ... of loop, writing each one to the <span>'s Node.textContent.

First, the HTML:

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

Now the JavaScript:

var span = document.querySelector("span");
var classes = span.classList;
var iterator = classes.values();

for(var value of iterator) {
  span.textContent += value + ' ++ ';
}

The output looks like this:

Specifications

Specification Status Comment
DOM
The definition of 'values() (as iterable<Node>)' in that specification.
Living Standard Initial definition

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support Yes ?50 ? Yes ?
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support Yes Yes ?50 Yes ? Yes

Document Tags and Contributors

Contributors to this page: fscholz, chrisdavidmills, jpmedley, teoli
Last updated by: fscholz,