CKTIS / JavaScript
NodeList — una raccolta di nodi DOM
NodeList è una raccolta indicizzata e iterabile di nodi DOM. Può essere dinamica o statica, a seconda dell’API che la restituisce.
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
list.length; list[index]; list.item(index); for (const node of list) { /* ... */ }NodeList è un’interfaccia DOM, non un array JavaScript. Per impostazione predefinita, i nodi seguono l’ordine dell’albero, a meno che l’API che definisce la raccolta non specifichi un ordine diverso. length indica il numero di nodi. Gli indici partono da zero. L’argomento di item(index) viene prima convertito in un intero senza segno a 32 bit (tipo unsigned long di Web IDL). Il metodo restituisce null se l’indice ottenuto dopo la conversione è fuori intervallo. L’accesso con list[index] usa una chiave di proprietà e non esegue questa conversione. In una raccolta non vuota, quindi, list.item(2 ** 32) restituisce il primo nodo (indice 0), mentre list[2 ** 32] restituisce normalmente undefined.
childNodes restituisce una raccolta dinamica, aggiornata dopo le modifiche al DOM, che include anche i nodi di testo. querySelectorAll() restituisce una raccolta statica degli elementi corrispondenti. Statico si riferisce agli elementi della raccolta, non all’immutabilità dei nodi stessi.
Usa for...of per scorrere la raccolta. Modificare il DOM mentre si itera su una raccolta dinamica può cambiarne il contenuto e gli indici. Se ti serve una composizione fissa, crea prima un array con Array.from(list).
Esempi
const root = document.createElement('div');
root.append(document.createElement('span'));
const live = root.childNodes;
const snapshot = root.querySelectorAll('span');
root.append(document.createElement('span'));
console.log(live.length, snapshot.length);
console.log(snapshot.item(9) === null);
let count = 0;
for (const node of live) count++;
console.log(count);Risultato
2 1 true 2
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.