CKTIS / JavaScript
NodeList — kolekcja węzłów DOM
NodeList to kolekcja węzłów DOM dostępna przez indeksy i iterację. Może być żywa albo statyczna — zależnie od API, które ją zwraca.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
list.length; list[index]; list.item(index); for (const node of list) { /* ... */ }NodeList to interfejs DOM, nie tablica JavaScript. Domyślnie węzły są uporządkowane zgodnie z kolejnością w drzewie, chyba że API definiujące kolekcję określa inną kolejność. length podaje liczbę węzłów. Indeksy zaczynają się od zera. Argument item(index) jest najpierw konwertowany na 32-bitową liczbę całkowitą bez znaku (typ unsigned long w Web IDL). Metoda zwraca null, jeśli indeks po konwersji jest poza zakresem. Odczyt list[index] używa klucza właściwości bez tej konwersji. Dlatego dla niepustej kolekcji list.item(2 ** 32) zwraca pierwszy węzeł (indeks 0), natomiast list[2 ** 32] zwykle zwraca undefined.
childNodes zwraca żywą kolekcję, aktualizowaną po zmianach DOM, również zawierającą węzły tekstowe. querySelectorAll() zwraca statyczną kolekcję pasujących elementów. Statyczność dotyczy składu kolekcji, nie niezmienności samych węzłów.
Użyj for...of, aby przejść po kolekcji. Zmiana DOM podczas iterowania po żywej kolekcji może zmienić jej zawartość i indeksy; gdy potrzebujesz stałego składu, najpierw utwórz tablicę przez Array.from(list).
Przykłady
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);Wynik
2 1 true 2
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.