Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

HTMLCollection.length — nombre d’éléments d’une collection

HTMLCollection.length renvoie le nombre actuel d’éléments d’une collection DOM. Cette propriété est en lecture seule et sa valeur est automatiquement mise à jour lorsque le contenu de la collection vivante change.

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

HTMLCollection.length est une propriété en lecture seule qui renvoie un entier non négatif : le nombre d’éléments de la collection. Lisez-la sous la forme collection.length, sans parenthèses d’appel. Une collection vide a une longueur de 0. Les indices commencent à 0 ; le dernier indice d’une collection non vide est donc collection.length - 1.

Une HTMLCollection est vivante : les modifications du DOM qui affectent son contenu mettent automatiquement à jour la collection et sa propriété length. Dans l’exemple, container.children ne comprend que les enfants directs qui sont des éléments. Ajouter un nœud texte n’augmente pas le nombre, contrairement à l’ajout d’un élément. La même référence items reflète également la suppression ultérieure de l’élément.

Ne traitez pas une HTMLCollection comme un tableau : affecter une valeur à length ne permet pas de la raccourcir. Modifiez plutôt les éléments DOM concernés. La suppression d’éléments pendant une itération peut décaler les indices et entraîner l’omission de certains éléments. Si vous prévoyez de telles modifications, parcourez une copie créée avec Array.from(collection).

Il s’agit d’une API du DOM des navigateurs, et non d’une fonctionnalité d’une édition particulière d’ECMAScript. MDN indique que cette propriété est largement disponible dans les navigateurs depuis juillet 2015. La présence de Node 24 dans un dépôt ne prouve ni la disponibilité du DOM ni la prise en charge de cette API par les navigateurs.

Exemples

(() => {
  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);
})();

Résultat

0
0
1
0

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources