CKTIS / JavaScript
NodeList — une collection de nœuds DOM
NodeList est une collection indexée et itérable de nœuds DOM. Elle peut être dynamique ou statique, selon l’API qui la renvoie.
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
list.length; list[index]; list.item(index); for (const node of list) { /* ... */ }NodeList est une interface DOM, et non un tableau JavaScript. Par défaut, les nœuds suivent l’ordre de l’arbre, sauf si l’API qui définit la collection spécifie un autre ordre. length indique le nombre de nœuds. Les indices commencent à zéro. L’argument de item(index) est d’abord converti en entier non signé sur 32 bits (type unsigned long de Web IDL). La méthode renvoie null si l’indice obtenu après conversion est hors limites. L’accès avec list[index] utilise une clé de propriété sans effectuer cette conversion. Dans une collection non vide, list.item(2 ** 32) renvoie donc le premier nœud (indice 0), tandis que list[2 ** 32] renvoie normalement undefined.
childNodes renvoie une collection dynamique, mise à jour après les modifications du DOM, qui inclut également les nœuds texte. querySelectorAll() renvoie une collection statique des éléments correspondants. Le caractère statique concerne les éléments présents dans la collection, et non l’immuabilité des nœuds eux-mêmes.
Utilisez for...of pour parcourir la collection. Modifier le DOM pendant l’itération sur une collection dynamique peut changer son contenu et ses indices. Si vous avez besoin d’une composition fixe, créez d’abord un tableau avec Array.from(list).
Exemples
const root = document.createElement('div');
root.append(document.createElement('span'));
const live = root.childNodes;
const snapshot = root.querySelectorAll('span');
root.append(document.createElement('span'));
console.log(live.length, snapshot.length);
console.log(snapshot.item(9) === null);
let count = 0;
for (const node of live) count++;
console.log(count);Résultat
2 1 true 2
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.