CKTIS / JavaScript
HTMLCollection.length — брой елементи в колекция
HTMLCollection.length връща текущия брой елементи в DOM колекция. Свойството е само за четене и стойността му се актуализира автоматично, когато съдържанието на живата колекция се промени.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
collection.lengthHTMLCollection.length е свойство само за четене, което връща неотрицателно цяло число: броя на елементите в колекцията. Чете се като collection.length, без скоби за извикване. Празната колекция има дължина 0. Индексите започват от 0, затова последният индекс на непразна колекция е collection.length - 1.
HTMLCollection е жива: промените в DOM, които засягат съдържанието ѝ, автоматично актуализират колекцията и свойството ѝ length. В примера container.children включва само преките деца, които са елементи. Добавянето на текстов възел не увеличава броя, но добавянето на елемент го увеличава. Същата препратка items отразява и последващото премахване на елемента.
Не третирайте HTMLCollection като масив: присвояването на стойност на length не е начин да я съкратите. Вместо това променяйте съответните DOM елементи. Премахването на елементи по време на обхождане може да размести индексите и да доведе до пропускане на записи. Ако планирате такива промени, обхождайте копие, създадено с Array.from(collection).
Това е API на DOM в браузъра, а не функция на конкретно издание на ECMAScript. MDN посочва, че свойството е широко достъпно в браузърите от юли 2015 г. Наличието на Node 24 в хранилище не доказва, че DOM е наличен или че браузърите поддържат това API.
Примери
(() => {
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);
})();Резултат
0 0 1 0
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.