CKTIS / JavaScript
NodeList — een verzameling DOM-nodes
NodeList is een geïndexeerde, itereerbare verzameling DOM-nodes. Afhankelijk van de API die de verzameling teruggeeft, kan deze live of statisch zijn.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
list.length; list[index]; list.item(index); for (const node of list) { /* ... */ }NodeList is een DOM-interface, geen JavaScript-array. De nodes staan standaard in boomvolgorde, tenzij de API die de verzameling definieert een andere volgorde voorschrijft. length geeft het aantal nodes aan. Indexen beginnen bij nul. Het argument van item(index) wordt eerst omgezet in een 32-bits geheel getal zonder teken (het type unsigned long in Web IDL). De methode geeft null terug als de index na omzetting buiten het bereik valt. Bij toegang via list[index] wordt een eigenschapssleutel gebruikt zonder die omzetting. Bij een niet-lege verzameling geeft list.item(2 ** 32) daarom de eerste node (index 0) terug, terwijl list[2 ** 32] normaal gesproken undefined oplevert.
childNodes geeft een live verzameling terug die wordt bijgewerkt na wijzigingen aan de DOM en ook tekstnodes bevat. querySelectorAll() geeft een statische verzameling van overeenkomende elementen terug. Statisch slaat op de samenstelling van de verzameling, niet op de onveranderlijkheid van de nodes zelf.
Gebruik for...of om de verzameling te doorlopen. Wijzigingen aan de DOM tijdens het itereren over een live verzameling kunnen de inhoud en indexen ervan veranderen. Als je een vaste samenstelling nodig hebt, maak dan eerst een array met Array.from(list).
Voorbeelden
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);Resultaat
2 1 true 2
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.