Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes