Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.length

NodeList.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.

Źródła