CKTIS / JavaScript
NodeList.length — liczba węzłów
NodeList.length to właściwość tylko do odczytu, która podaje liczbę węzłów w kolekcji, niekoniecznie samych elementów.
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
nodeList.lengthNodeList.length zwraca liczbę węzłów w kolekcji jako nieujemną liczbę całkowitą; dla pustej kolekcji wynosi 0. To właściwość tylko do odczytu, nie metoda: używaj nodeList.length, bez nawiasów. Indeksy zaczynają się od 0 i kończą na length - 1.
Wynik zależy od kolekcji. childNodes obejmuje również węzły tekstowe i komentarze. Jest kolekcją żywą, więc jej długość odzwierciedla zmiany DOM. querySelectorAll() zwraca statyczną kolekcję: późniejsze zmiany DOM nie aktualizują jej długości.
To API DOM, nie funkcja samego ECMAScript. Przykład pokazuje obie kolekcje na odłączonym elemencie.
Przykłady
const container = document.createElement("div");
container.appendChild(document.createTextNode("hello"));
container.appendChild(document.createElement("span"));
const live = container.childNodes;
const snapshot = container.querySelectorAll("span");
console.log(live.length, snapshot.length);
container.appendChild(document.createElement("span"));
console.log(live.length, snapshot.length);Wynik
2 1 3 1
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.