База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

NodeList.forEach — обхождане на възли

NodeList.forEach извиква функция за всеки пореден възел от DOM колекция и ѝ предава възела, индекса и колекцията.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

nodeList.forEach(callback[, thisArg])
callback(node, index, nodeList)

NodeList.forEach, достъпен като NodeList.prototype.forEach, извиква callback(node, index, nodeList) по реда на индексите, започвайки от нула. Връща undefined; върнатите стойности от callback функцията се игнорират. При извикването на callback функцията методът подава незадължителния аргумент thisArg като стойност за this, но this вътре във функцията не е задължително да има точно тази стойност. Обикновена функция извън строг режим заменя null или undefined със своята глобална стойност на this, а останалите примитивни стойности обвива в обекти. Стрелкова функция използва this от обхващащата я област на видимост.

NodeList не е масив. querySelectorAll() връща статичен списък, докато childNodes е жив списък, който включва и текстови възли. Избягвайте да променяте жива колекция по време на обхождането ѝ.

Това е Web API, а не функция на конкретно издание на ECMAScript. Node 24 не доказва поддръжка на DOM. В целевата среда проверете typeof nodes.forEach === 'function'.

Примери

const root = document.createElement('div');
for (const text of ['A', 'B']) {
  const item = document.createElement('span');
  item.textContent = text;
  root.appendChild(item);
}
const nodes = root.querySelectorAll('span');
const lines = [];
nodes.forEach((node, index, list) => {
  lines.push(`${index}:${node.textContent}:${list === nodes}`);
});
console.log(lines.join('\n'));

Резултат

0:A:true
1:B:true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници