Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

NodeList.length — numero di nodi

NodeList.length è una proprietà di sola lettura che indica il numero di nodi in una raccolta, non necessariamente solo il numero di elementi.

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

nodeList.length

NodeList.length restituisce il numero di nodi della raccolta sotto forma di intero non negativo. Per una raccolta vuota, il valore è 0. È una proprietà di sola lettura, non un metodo: usa nodeList.length, senza parentesi. Gli indici iniziano da 0 e terminano con length - 1.

Il risultato dipende dalla raccolta. childNodes include anche nodi di testo e commenti. È una raccolta dinamica, quindi la sua lunghezza rispecchia le modifiche al DOM. querySelectorAll() restituisce una raccolta statica: le modifiche successive al DOM non ne aggiornano la lunghezza.

Questa è un’API DOM, non una funzionalità del linguaggio ECMAScript. L’esempio mostra entrambe le raccolte usando un elemento non inserito nel documento.

Esempi

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);

Risultato

2 1
3 1

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