CKTIS / JavaScript
NodeList.length — nombre de nœuds
NodeList.length est une propriété en lecture seule qui indique le nombre de nœuds d’une collection, et pas nécessairement uniquement le nombre d’éléments.
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
nodeList.lengthNodeList.length renvoie le nombre de nœuds de la collection sous la forme d’un entier non négatif. Pour une collection vide, sa valeur est 0. C’est une propriété en lecture seule, et non une méthode : utilisez nodeList.length, sans parenthèses. Les index commencent à 0 et se terminent à length - 1.
Le résultat dépend de la collection. childNodes inclut aussi les nœuds texte et les nœuds de commentaire. Cette collection est dynamique : sa longueur reflète donc les modifications du DOM. querySelectorAll() renvoie une collection statique : les modifications ultérieures du DOM ne mettent pas à jour sa longueur.
Il s’agit d’une API DOM, et non d’une fonctionnalité du langage ECMAScript. L’exemple présente les deux collections avec un élément détaché du document.
Exemples
const container = document.createElement("div");
container.appendChild(document.createTextNode("hello"));
container.appendChild(document.createElement("span"));
const live = container.childNodes;
const snapshot = container.querySelectorAll("span");
console.log(live.length, snapshot.length);
container.appendChild(document.createElement("span"));
console.log(live.length, snapshot.length);Résultat
2 1 3 1
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.