DOMTokenList: forEach() method

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

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

{{APIRef("DOM")}}

The **forEach()** method of the {{domxref("DOMTokenList")}} interface calls the callback given in parameter once for each value pair in the list, in insertion order.

Syntax

js-nolint
forEach(callback)
forEach(callback, thisArg)

Parameters

  • callback
  • : The function to execute for each element, eventually taking three arguments:
  • currentValue
  • : The current element being processed in the array.
  • currentIndex
  • : The index of the current element being processed in the array.
  • listObj
  • : The array that forEach() is being applied to.
  • thisArg {{Optional_inline}}
  • : The value to use as {{jsxref("this")}} when executing callback.

Return value

None.

Example

In the following example we retrieve the list of classes set on a {{htmlelement("pre")}} element as a DOMTokenList using {{domxref("Element.classList")}}. We then retrieve an iterator containing the values using forEach(), writing each one to the <pre>'s {{domxref("Node.textContent")}} inside the forEach() inner function.

HTML

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

JavaScript

js
const pre = document.querySelector("pre");
const classes = pre.classList;
const iterator = classes.values();

classes.forEach(function (value, key, listObj) {
  pre.textContent += `(${value} ${key})/${this}\n`;
}, "arg");

Result

{{ EmbedLiveSample('Example', '100%', 100) }}

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

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