The forEach()
method of the NodeList
interface calls the callback given in parameter once for each value pair in the list, in insertion order.
On this page
NodeList: forEach() method
Syntax
js
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 insomeNodeList
. listObj
Optional-
The
someNodeList
thatforEach()
is being applied to.
-
thisArg
Optional-
Value to use as
this
when executingcallback
.
Return value
Example
js
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
Specification |
---|
DOM Standard # interface-nodelist |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
forEach |
51 | 16 | 50 | No | 38 | 10 | 51 | 51 | 50 | 41 | 10 | 5.0 |
See also
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/NodeList/forEach