CKTIS / JavaScript
HTMLCollection.length — broj elemenata u kolekciji
HTMLCollection.length vraća trenutačan broj elemenata u DOM kolekciji. Svojstvo je samo za čitanje, a njegova se vrijednost automatski ažurira kada se promijeni sadržaj žive kolekcije.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
collection.lengthHTMLCollection.length je svojstvo samo za čitanje koje vraća nenegativan cijeli broj: broj elemenata u kolekciji. Čita se kao collection.length, bez zagrada za poziv. Prazna kolekcija ima duljinu 0. Indeksi počinju od 0, pa je posljednji indeks neprazne kolekcije collection.length - 1.
HTMLCollection je živa: promjene u DOM-u koje utječu na njezin sadržaj automatski ažuriraju kolekciju i njezino svojstvo length. U primjeru container.children obuhvaća samo izravnu djecu koja su elementi. Dodavanje tekstualnog čvora ne povećava broj, dok ga dodavanje elementa povećava. Ista referenca items odražava i naknadno uklanjanje elementa.
Nemojte tretirati HTMLCollection kao polje: dodjeljivanje vrijednosti svojstvu length ne skraćuje je. Umjesto toga promijenite odgovarajuće DOM elemente. Uklanjanje elemenata tijekom iteracije može pomaknuti indekse i uzrokovati preskakanje stavki. Ako planirate takve promjene, iterirajte po kopiji stvorenoj pomoću Array.from(collection).
Ovo je API DOM-a preglednika, a ne značajka određene inačice ECMAScripta. MDN navodi da je ovo svojstvo široko dostupno u preglednicima od srpnja 2015. Prisutnost Nodea 24 u repozitoriju ne dokazuje dostupnost DOM-a ni podršku preglednika za ovaj API.
Primjeri
(() => {
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);
})();Rezultat
0 0 1 0
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.