DOMTokenList: forEach() 方法

Baseline 已广泛支持

此功能已非常成熟,可在多种设备和浏览器版本上使用。自 2017 年 10 月以来,它已在各大浏览器中可用。

DOMTokenList 接口的 forEach() 方法会调用参数中提供的回调函数一次,用于列表中的每个值对,按插入顺序执行。

语法

js
forEach(callback)
forEach(callback, thisArg)

参数

回调

为每个元素执行的函数,最终接受三个参数

currentValue

数组中正在处理的当前元素。

currentIndex

数组中正在处理的当前元素的索引。

listObj

正在应用 forEach() 的数组。

thisArg 可选

执行 callback 时用作 this 的值。

返回值

无。

示例

在以下示例中,我们使用 Element.classList 来检索设置在 <pre> 元素上的类列表,将其作为 DOMTokenList。然后,我们使用 forEach() 检索包含这些值的迭代器,并在 forEach() 内部函数中将每个值写入 <pre>Node.textContent

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");

结果

规范

此特性似乎未在任何规范中定义。

浏览器兼容性

另见