Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

NodeList.length — número de nodos

NodeList.length es una propiedad de solo lectura que indica el número de nodos de una colección, que no tienen por qué ser únicamente elementos.

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

nodeList.length

NodeList.length devuelve el número de nodos de la colección como un entero no negativo. En una colección vacía, su valor es 0. Es una propiedad de solo lectura, no un método: usa nodeList.length, sin paréntesis. Los índices empiezan en 0 y terminan en length - 1.

El resultado depende de la colección. childNodes también incluye nodos de texto y comentarios. Es una colección viva, por lo que su longitud refleja los cambios del DOM. querySelectorAll() devuelve una colección estática: los cambios posteriores del DOM no actualizan su longitud.

Esta es una API del DOM, no una característica del lenguaje ECMAScript. El ejemplo muestra ambas colecciones usando un elemento separado del documento.

Ejemplos

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

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.

Fuentes