DOMTokenList: entries() method

فهرست فصل‌ها دانلود آرشیوناشر

MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونه‌کد

{{APIRef("DOM")}}

The **entries()** method of the {{domxref("DOMTokenList")}} interface returns an {{jsxref("Iteration_protocols",'iterator')}} allowing you to go through all key/value pairs contained in this object. The values are {{jsxref("Array")}}s which have [key, value] pairs, each representing a single token.

Syntax

js-nolint
entries()

Parameters

None.

Return value

Returns an {{jsxref("Iteration_protocols","iterator")}}.

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 key/value pairs using entries(), then iterate through each one using a {{jsxref("Statements/for...of", "for...of")}} loop, writing them to the <span>'s {{domxref("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:

{{ EmbedLiveSample('Examples', '100%', 60) }}

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • [Polyfill of DOMTokenList.prototype.entries in core-js](https://core-js.io/docs/features/web-standards/iterable-dom-collections)
  • {{domxref("DOMTokenList.foreach()")}}, {{domxref("DOMTokenList.keys")}} and {{domxref("DOMTokenList.values")}}.