MDN self-hosted library · e01.org

NodeList: forEach() method

DOM

DOM

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
    • : The index of the currentValue being processed in someNodeList.
    • listObj
    • : The someNodeList that forEach() is being applied to.
  • thisArg

  • : 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