Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

NodeList — zbirka vozlišč DOM

NodeList je indeksirana in iterabilna zbirka vozlišč DOM. Glede na API, ki jo vrne, je lahko živa ali statična.

Različica: 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 vmesnik DOM, ne pa polje JavaScript. Vozlišča so privzeto razvrščena po vrstnem redu v drevesu, razen če API, ki opredeljuje zbirko, določa drugačen vrstni red. length podaja število vozlišč. Indeksi se začnejo z nič. Argument metode item(index) se najprej pretvori v 32-bitno nepredznačeno celo število (tip unsigned long v Web IDL). Metoda vrne null, če je indeks po pretvorbi zunaj obsega. Dostop z list[index] uporabi ključ lastnosti in te pretvorbe ne izvede. V neprazni zbirki zato list.item(2 ** 32) vrne prvo vozlišče (indeks 0), list[2 ** 32] pa običajno vrne undefined.

childNodes vrne živo zbirko, ki se posodobi ob spremembah DOM in vključuje tudi besedilna vozlišča. querySelectorAll() vrne statično zbirko ujemajočih se elementov. Statičnost se nanaša na sestavo zbirke, ne pa na nespremenljivost samih vozlišč.

Za pregled zbirke uporabi for...of. Spreminjanje DOM med iteracijo po živi zbirki lahko spremeni njeno vsebino in indekse. Če potrebuješ nespremenljivo sestavo, najprej ustvari polje z Array.from(list).

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri