CKTIS / JavaScript
NodeList — una colección de nodos DOM
NodeList es una colección indexada e iterable de nodos DOM. Puede ser dinámica o estática, según la API que la devuelva.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
list.length; list[index]; list.item(index); for (const node of list) { /* ... */ }NodeList es una interfaz del DOM, no un array de JavaScript. Por defecto, los nodos siguen el orden del árbol, salvo que la API que define la colección especifique otro orden. length indica cuántos nodos hay. Los índices empiezan en cero. El argumento de item(index) se convierte primero en un entero de 32 bits sin signo (tipo unsigned long de Web IDL). El método devuelve null si el índice resultante está fuera de rango. El acceso con list[index] usa una clave de propiedad y no realiza esa conversión. Por eso, si la colección no está vacía, list.item(2 ** 32) devuelve el primer nodo (índice 0), mientras que list[2 ** 32] normalmente devuelve undefined.
childNodes devuelve una colección dinámica que se actualiza tras los cambios en el DOM y que también incluye nodos de texto. querySelectorAll() devuelve una colección estática de los elementos que coinciden. Estática se refiere a los elementos que forman la colección, no a que los nodos sean inmutables.
Usa for...of para recorrer la colección. Cambiar el DOM mientras se itera sobre una colección dinámica puede modificar su contenido y sus índices. Si necesitas que la composición no cambie, crea primero un array con Array.from(list).
Ejemplos
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);Resultado
2 1 true 2
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.