База знанияИзпитен център
BGБългарски
Избери език13

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

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници