NodeList: forEach() method

The forEach() method of the NodeList interface calls the callback given in parameter once for each value pair in the list, in insertion order.

Syntax

forEach(callback)
forEach(callback, thisArg)

Parameters

• callback

  • : A function to execute on each element of someNodeList. It accepts 3 parameters:
    • currentValue
      • : The current element being processed in someNodeList.
    • currentIndex Optional
      • : The index of the currentValue being processed in someNodeList.
    • listObj Optional
      • : The someNodeList that forEach() is being applied to.

• thisArg Optional

  • : Value to use as this when executing callback.

Return value

undefined.

Example

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

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

const list = node.childNodes;

list.forEach(function (currentValue, currentIndex, listObj) {
  console.log(`${currentValue}, ${currentIndex}, ${this}`);
}, "myThisArg");

The above code results in the following:

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

Specifications

Browser compatibility

See also

• Polyfill of NodeList.prototype.forEach in core-js
• Node
• NodeList