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

CKTIS / JavaScript

NodeList.length — número de nós

NodeList.length é uma propriedade só de leitura que indica o número de nós de uma coleção, não necessariamente apenas o número de elementos.

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

nodeList.length

NodeList.length devolve o número de nós da coleção sob a forma de um número inteiro não negativo. Numa coleção vazia, o valor é 0. É uma propriedade só de leitura, não um método: utiliza nodeList.length, sem parênteses. Os índices começam em 0 e terminam em length - 1.

O resultado depende da coleção. childNodes inclui também nós de texto e comentários. É uma coleção dinâmica, pelo que o seu comprimento reflete as alterações ao DOM. querySelectorAll() devolve uma coleção estática: alterações posteriores ao DOM não atualizam o seu comprimento.

Esta é uma API DOM, não uma funcionalidade da linguagem ECMAScript. O exemplo mostra ambas as coleções utilizando um elemento desligado do documento.

Exemplos

const container = document.createElement("div");
container.appendChild(document.createTextNode("hello"));
container.appendChild(document.createElement("span"));

const live = container.childNodes;
const snapshot = container.querySelectorAll("span");
console.log(live.length, snapshot.length);

container.appendChild(document.createElement("span"));
console.log(live.length, snapshot.length);

Resultado

2 1
3 1

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