Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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

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

Izvori