Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

HTMLCollection.length — numero di elementi in una raccolta

HTMLCollection.length restituisce il numero attuale di elementi in una raccolta DOM. È di sola lettura e il suo valore si aggiorna automaticamente quando cambia il contenuto della raccolta live.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

collection.length

HTMLCollection.length è una proprietà di sola lettura che restituisce un intero non negativo: il numero di elementi nella raccolta. Si legge come collection.length, senza parentesi di chiamata. Una raccolta vuota ha lunghezza 0. Gli indici partono da 0, quindi l'ultimo indice di una raccolta non vuota è collection.length - 1.

Una HTMLCollection è live: le modifiche al DOM che ne influenzano il contenuto aggiornano automaticamente la raccolta e la sua proprietà length. Nell'esempio, container.children include solo i figli diretti che sono elementi. Aggiungere un nodo di testo non aumenta il conteggio, mentre aggiungere un elemento sì. La stessa referenza items riflette anche la successiva rimozione dell'elemento.

Non trattare una HTMLCollection come un array: assegnare un valore a length non è un modo per accorciarla. Modifica invece gli elementi DOM interessati. La rimozione di elementi durante un'iterazione può spostare gli indici e far saltare alcune voci. Se prevedi di apportare tali modifiche, itera su una copia creata con Array.from(collection).

Questa è un'API del DOM dei browser, non una funzionalità di una particolare edizione di ECMAScript. MDN indica che questa proprietà è ampiamente disponibile nei browser da luglio 2015. La presenza di Node 24 in un repository non dimostra né la disponibilità del DOM né il supporto di questa API nei browser.

Esempi

(() => {
  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);
})();

Risultato

0
0
1
0

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti