DOMTokenList: keys() method
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("DOM")}}
The **keys()** method of the {{domxref("DOMTokenList")}} interface returns an {{jsxref("Iteration_protocols",'iterator',"",1)}} allowing you to go through all keys contained in this object. The keys are unsigned integers.
Syntax
keys()Parameters
None.
Return value
Returns an {{jsxref("Iteration_protocols","iterator","",1)}}.
Examples
In the following example we retrieve the list of classes set on a {{htmlelement("span")}} element as a DOMTokenList using {{domxref("Element.classList")}}. We then retrieve an iterator containing the keys using keys(), then iterate through those keys using a for...of loop, writing each one to the <span>'s {{domxref("Node.textContent")}}.
First, the HTML:
<span class="a b c"></span>Now the JavaScript:
const span = document.querySelector("span");
const classes = span.classList;
const iterator = classes.keys();
for (let value of iterator) {
span.textContent += `(${value}) `;
}The output looks like this:
{{ EmbedLiveSample('Examples', '100%', 60) }}
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- [Polyfill of
DOMTokenList.prototype.keysincore-js](https://core-js.io/docs/features/web-standards/iterable-dom-collections) - {{domxref("DOMTokenList.entries()")}}, {{domxref("DOMTokenList.forEach()")}} and {{domxref("DOMTokenList.values")}}.