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

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.

Sources