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

CKTIS / JavaScript

HTMLCollection.length — número de elementos de una colección

HTMLCollection.length devuelve el número actual de elementos de una colección DOM. Es de solo lectura y su valor se actualiza automáticamente cuando cambia el contenido de la colección viva.

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

collection.length

HTMLCollection.length es una propiedad de solo lectura que devuelve un entero no negativo: el número de elementos de la colección. Se lee como collection.length, sin paréntesis de llamada. Una colección vacía tiene una longitud de 0. Los índices empiezan en 0, por lo que el último índice de una colección no vacía es collection.length - 1.

Una HTMLCollection está viva: los cambios en el DOM que afectan a su contenido actualizan automáticamente la colección y su propiedad length. En el ejemplo, container.children incluye únicamente los hijos directos que son elementos. Añadir un nodo de texto no aumenta el recuento, pero añadir un elemento sí. La misma referencia items también refleja la eliminación posterior del elemento.

No trates una HTMLCollection como un array: asignar un valor a length no sirve para reducirla. Cambia los elementos DOM correspondientes. Al eliminar elementos durante una iteración, los índices pueden desplazarse y algunas entradas pueden omitirse. Si tienes previsto hacer esos cambios, recorre una copia creada con Array.from(collection).

Esta es una API del DOM de los navegadores, no una característica de una edición concreta de ECMAScript. MDN indica que esta propiedad está ampliamente disponible en los navegadores desde julio de 2015. La presencia de Node 24 en un repositorio no demuestra que haya un DOM disponible ni que los navegadores admitan esta API.

Ejemplos

(() => {
  const container = document.createElement("div");
  const items = container.children;

  console.log(items.length);
  container.appendChild(document.createTextNode("text"));
  console.log(items.length);
  const child = document.createElement("span");
  container.appendChild(child);
  console.log(items.length);
  container.removeChild(child);
  console.log(items.length);
})();

Resultado

0
0
1
0

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