CKTIS / JavaScript
HTMLCollection.length — liczba elementów w kolekcji
Właściwość HTMLCollection.length zwraca bieżącą liczbę elementów w kolekcji DOM. Jest tylko do odczytu, a jej wartość aktualizuje się automatycznie, gdy zmienia się zawartość żywej kolekcji.
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
collection.lengthHTMLCollection.length to właściwość tylko do odczytu, zwracająca nieujemną liczbę całkowitą: liczbę elementów w kolekcji. Odczytuj ją jako collection.length, bez nawiasów wywołania. Pusta kolekcja ma długość 0. Indeksy zaczynają się od 0, więc dla niepustej kolekcji ostatni indeks to collection.length - 1.
HTMLCollection jest żywa: zmiany w DOM wpływające na jej zawartość automatycznie aktualizują kolekcję i jej length. W przykładzie container.children obejmuje wyłącznie bezpośrednie dzieci będące elementami. Dodanie węzła tekstowego nie zwiększa licznika, ale dodanie elementu go zwiększa. Ta sama referencja items odzwierciedla także późniejsze usunięcie elementu.
Nie traktuj HTMLCollection jak tablicy: przypisanie do length nie służy do jej skracania. Zmieniaj odpowiednie elementy DOM. Podczas iteracji usuwanie elementów może przesuwać indeksy i prowadzić do pomijania pozycji; jeśli planujesz takie zmiany, iteruj po kopii utworzonej przez Array.from(collection).
To API przeglądarkowego DOM, a nie funkcja określonej edycji ECMAScript. MDN oznacza tę właściwość jako szeroko dostępną w przeglądarkach od lipca 2015 roku. Sama obecność Node 24 w repozytorium nie potwierdza dostępności DOM ani obsługi tego API w przeglądarkach.
Przykłady
(() => {
const container = document.createElement("div");
const items = container.children;
console.log(items.length);
container.appendChild(document.createTextNode("text"));
console.log(items.length);
const child = document.createElement("span");
container.appendChild(child);
console.log(items.length);
container.removeChild(child);
console.log(items.length);
})();Wynik
0 0 1 0
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.