DOMTokenList: values() method
The values()
method of the DOMTokenList
interface
returns an iterator
allowing the caller to go through all values contained in the DOMTokenList
.
The individual values are strings.
Syntax
js
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:
html
<span class="a b c"></span>
Now the JavaScript:
js
const span = document.querySelector("span");
const classes = span.classList;
const iterator = classes.values();
for (const value of iterator) {
span.textContent += `(${value}) `;
}
The output looks like this:
Specifications
No specification found
No specification data found for api.DOMTokenList.values
.
Check for problems with this page or contribute a missing spec_url
to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.
Browser compatibility
BCD tables only load in the browser