Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

NodeList — kolekcia uzlov DOM

NodeList je indexovaná a iterovateľná kolekcia uzlov DOM. Podľa API, ktoré ju vracia, môže byť živá alebo statická.

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

Syntax

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

NodeList je rozhranie DOM, nie pole JavaScriptu. Uzly sú predvolene zoradené podľa poradia v strome, pokiaľ API, ktoré kolekciu definuje, neurčí iné poradie. length udáva počet uzlov. Indexy sa začínajú nulou. Argument item(index) sa najprv prevedie na 32-bitové celé číslo bez znamienka (typ unsigned long vo Web IDL). Metóda vráti null, ak je index po prevode mimo rozsahu. Prístup cez list[index] používa kľúč vlastnosti a tento prevod nevykonáva. Pri neprázdnej kolekcii preto list.item(2 ** 32) vráti prvý uzol (index 0), zatiaľ čo list[2 ** 32] zvyčajne vráti undefined.

childNodes vracia živú kolekciu, ktorá sa aktualizuje po zmenách DOM a obsahuje aj textové uzly. querySelectorAll() vracia statickú kolekciu zodpovedajúcich prvkov. Statická je kolekcia z hľadiska svojho zloženia, nie z hľadiska nemennosti samotných uzlov.

Na prechádzanie kolekcie použi for...of. Zmena DOM počas iterácie cez živú kolekciu môže zmeniť jej obsah a indexy. Ak potrebuješ nemenné zloženie, najprv vytvor pole pomocou Array.from(list).

Príklady

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

Výsledok

2 1
true
2

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje