NodeList.prototype.forEach() - Web API 接口参考 编辑

NodeList接口的 forEach() 方法按插入顺序为列表中的每个值对调用一次参数中给定的回调。

语法

someNodeList.forEach(callback[, thisArg]);

参数

callback

为 someNodeList的每一个元素执行函数。它接受以下三个参数：

currentValue

someNodeList中的当前元素。

currentIndex 可选

someNodeList中的currentValue所对应的索引值。

listObj 可选

someNodeList 在 forEach() 方法中所属的NodeList对象。

thisArg 可选

传递 callback 的值一般用this值。

返回值

undefined.

Exceptions

None.

示例

let node = document.createElement("div");
let kid1 = document.createElement("p");
let kid2 = document.createTextNode("hey");
let kid3 = document.createElement("span");

node.appendChild(kid1);
node.appendChild(kid2);
node.appendChild(kid3);

let list = node.childNodes;

list.forEach(
  function(currentValue, currentIndex, listObj) {
    console.log(currentValue + ', ' + currentIndex + ', ' + this);
  },
  'myThisArg'
);

上述代码会产生以下结果：

[object HTMLParagraphElement], 0, myThisArg
[object Text], 1, myThisArg
[object HTMLSpanElement], 2, myThisArg

Polyfill

polyfill 增加了对所有支持ES5的浏览器的兼容性：

if (window.NodeList && !NodeList.prototype.forEach) {
    NodeList.prototype.forEach = function (callback, thisArg) {
        thisArg = thisArg || window;
        for (var i = 0; i < this.length; i++) {
            callback.call(thisArg, this[i], i, this);
        }
    };
}

或者

if (window.NodeList && !NodeList.prototype.forEach) {
   NodeList.prototype.forEach = Array.prototype.forEach;
}

上面的代码是大部分浏览器实现的 NodeList.prototype.forEach() (例如Chrome).

Specifications

Specification	Status	Comment
Web IDL forEach	Candidate Recommendation	Defines forEach on iterable declarations

Browser Compatibility

BCD tables only load in the browser

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

See also

• Node
• NodeList