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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.