CKTIS / JavaScript
NodeList — uma coleção de nós DOM
NodeList é uma coleção indexada e iterável de nós DOM. Pode ser dinâmica ou estática, consoante a API que a devolve.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
list.length; list[index]; list.item(index); for (const node of list) { /* ... */ }NodeList é uma interface do DOM, não um array de JavaScript. Por predefinição, os nós seguem a ordem da árvore, a menos que a API que define a coleção especifique outra ordem. length indica o número de nós. Os índices começam em zero. O argumento de item(index) é primeiro convertido num inteiro de 32 bits sem sinal (tipo unsigned long de Web IDL). O método devolve null se o índice resultante estiver fora dos limites. O acesso com list[index] usa uma chave de propriedade e não faz essa conversão. Assim, numa coleção não vazia, list.item(2 ** 32) devolve o primeiro nó (índice 0), enquanto list[2 ** 32] normalmente devolve undefined.
childNodes devolve uma coleção dinâmica, atualizada após alterações ao DOM, que também inclui nós de texto. querySelectorAll() devolve uma coleção estática dos elementos correspondentes. Estática refere-se aos elementos que compõem a coleção, não à imutabilidade dos próprios nós.
Utiliza for...of para percorrer a coleção. Alterar o DOM durante a iteração sobre uma coleção dinâmica pode modificar o seu conteúdo e os seus índices. Se precisares de uma composição fixa, cria primeiro um array com Array.from(list).
Exemplos
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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.