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

CKTIS / JavaScript

NodeList — колекция от DOM възли

NodeList е индексирана и итерируема колекция от DOM възли. В зависимост от API, което я връща, тя може да бъде жива или статична.

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

Синтаксис

list.length; list[index]; list.item(index); for (const node of list) { /* ... */ }

NodeList е DOM интерфейс, а не JavaScript масив. По подразбиране възлите са подредени в реда на дървото, освен ако API, което дефинира колекцията, не задава друг ред. length показва броя на възлите. Индексите започват от нула. Аргументът на item(index) първо се преобразува в 32-битово цяло число без знак (тип unsigned long в Web IDL). Методът връща null, ако индексът след преобразуването е извън обхвата. Достъпът с list[index] използва ключ на свойство и не извършва това преобразуване. Затова при непразна колекция list.item(2 ** 32) връща първия възел (с индекс 0), докато list[2 ** 32] обикновено връща undefined.

childNodes връща жива колекция, която се актуализира след промени в DOM и включва и текстови възли. querySelectorAll() връща статична колекция от съвпадащите елементи. Статичността се отнася до състава на колекцията, а не до това дали самите възли са неизменни.

Използвай for...of, за да обходиш колекцията. Промяната на DOM по време на обхождане на жива колекция може да промени съдържанието и индексите ѝ. Ако ти е необходим фиксиран състав, първо създай масив с Array.from(list).

Примери

const root = document.createElement('div');
root.append(document.createElement('span'));

const live = root.childNodes;
const snapshot = root.querySelectorAll('span');
root.append(document.createElement('span'));

console.log(live.length, snapshot.length);
console.log(snapshot.item(9) === null);

let count = 0;
for (const node of live) count++;
console.log(count);

Резултат

2 1
true
2

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

Източници