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.lengthNodeList.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.