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.