Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

NodeList — zbirka DOM čvorova

NodeList je indeksirana i iterabilna zbirka DOM čvorova. Ovisno o API-ju koji je vraća, može biti živa ili statična.

Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

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

NodeList je DOM sučelje, a ne JavaScript polje. Čvorovi su prema zadanim postavkama poredani prema redoslijedu u stablu, osim ako API koji definira zbirku ne odredi drukčiji redoslijed. length daje broj čvorova. Indeksi počinju od nule. Argument metode item(index) najprije se pretvara u 32-bitni cijeli broj bez predznaka (tip unsigned long u Web IDL-u). Metoda vraća null ako je indeks nakon pretvorbe izvan raspona. Pristup pomoću list[index] koristi ključ svojstva i ne provodi tu pretvorbu. Zato u nepraznoj zbirci list.item(2 ** 32) vraća prvi čvor (indeks 0), dok list[2 ** 32] obično vraća undefined.

childNodes vraća živu zbirku koja se ažurira nakon promjena DOM-a i uključuje i tekstne čvorove. querySelectorAll() vraća statičnu zbirku elemenata koji odgovaraju upitu. Statičnost se odnosi na sastav zbirke, a ne na nepromjenjivost samih čvorova.

Za prolazak kroz zbirku upotrijebi for...of. Promjena DOM-a tijekom iteracije kroz živu zbirku može promijeniti njezin sadržaj i indekse. Ako ti treba nepromjenjiv sastav, najprije izradi polje pomoću Array.from(list).

Primjeri

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);

Rezultat

2 1
true
2

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori