CKTIS / JavaScript
HTMLCollection.length — počet prvků v kolekci
HTMLCollection.length vrací aktuální počet prvků v kolekci DOM. Je pouze pro čtení a její hodnota se automaticky aktualizuje, když se změní obsah živé kolekce.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
collection.lengthHTMLCollection.length je vlastnost pouze pro čtení, která vrací nezáporné celé číslo: počet prvků v kolekci. Čte se jako collection.length, bez závorek pro volání. Prázdná kolekce má délku 0. Indexy začínají na 0, takže poslední index neprázdné kolekce je collection.length - 1.
HTMLCollection je živá: změny v DOM, které ovlivňují její obsah, automaticky aktualizují kolekci i její vlastnost length. V příkladu container.children zahrnuje pouze přímé potomky, které jsou prvky. Přidání textového uzlu počet nezvýší, přidání prvku ano. Stejný odkaz items odráží také následné odebrání prvku.
Nepovažujte HTMLCollection za pole: přiřazením hodnoty do length ji nelze zkrátit. Místo toho změňte příslušné prvky DOM. Odebrání prvků během iterace může posunout indexy a způsobit přeskočení položek. Pokud takové změny plánujete, iterujte přes kopii vytvořenou pomocí Array.from(collection).
Jde o API DOM v prohlížeči, nikoli o funkci konkrétní edice ECMAScriptu. MDN uvádí, že tato vlastnost je široce dostupná v prohlížečích od července 2015. Přítomnost Node 24 v repozitáři nedokládá dostupnost DOM ani podporu tohoto API v prohlížečích.
Příklady
(() => {
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);
})();Výsledek
0 0 1 0
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.