CKTIS / JavaScript
NodeList — kolekce uzlů DOM
NodeList je indexovaná a iterovatelná kolekce uzlů DOM. Podle API, které ji vrací, může být živá nebo statická.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
list.length; list[index]; list.item(index); for (const node of list) { /* ... */ }NodeList je rozhraní DOM, nikoli pole JavaScriptu. Uzly jsou standardně seřazeny podle pořadí ve stromu, pokud API, které kolekci definuje, nestanoví jiné pořadí. length udává počet uzlů. Indexy začínají nulou. Argument item(index) se nejprve převede na 32bitové celé číslo bez znaménka (typ unsigned long ve Web IDL). Metoda vrátí null, pokud je index po převodu mimo rozsah. Přístup přes list[index] používá klíč vlastnosti a tento převod neprovádí. U neprázdné kolekce proto list.item(2 ** 32) vrátí první uzel (index 0), zatímco list[2 ** 32] obvykle vrátí undefined.
childNodes vrací živou kolekci, která se aktualizuje po změnách DOM a obsahuje také textové uzly. querySelectorAll() vrací statickou kolekci odpovídajících prvků. Statická je zde kolekce z hlediska svého složení, nikoli z hlediska neměnnosti samotných uzlů.
K procházení kolekce použijte for...of. Změna DOM během iterace přes živou kolekci může změnit její obsah a indexy. Pokud potřebujete neměnné složení, nejprve vytvořte pole pomocí Array.from(list).
Pří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ýsledek
2 1 true 2
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.