CKTIS / JavaScript
NodeList — eine Sammlung von DOM-Knoten
NodeList ist eine indizierte, iterierbare Sammlung von DOM-Knoten. Je nach API, die sie zurückgibt, kann sie live oder statisch sein.
Version: 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 ist eine DOM-Schnittstelle und kein JavaScript-Array. Die Knoten sind standardmäßig in Baumreihenfolge angeordnet, sofern die API, die die Sammlung definiert, keine andere Reihenfolge vorgibt. length gibt die Anzahl der Knoten an. Die Indizes beginnen bei null. Das Argument von item(index) wird zuerst in eine vorzeichenlose 32-Bit-Ganzzahl umgewandelt (Typ unsigned long in Web IDL). Die Methode gibt null zurück, wenn der umgewandelte Index außerhalb des gültigen Bereichs liegt. Der Zugriff mit list[index] verwendet einen Eigenschaftsschlüssel und nimmt diese Umwandlung nicht vor. Bei einer nicht leeren Sammlung gibt list.item(2 ** 32) daher den ersten Knoten (Index 0) zurück, während list[2 ** 32] normalerweise undefined ergibt.
childNodes gibt eine Live-Sammlung zurück, die bei Änderungen am DOM aktualisiert wird und auch Textknoten enthält. querySelectorAll() gibt eine statische Sammlung passender Elemente zurück. Statisch bezieht sich auf die Zusammensetzung der Sammlung, nicht darauf, dass die Knoten selbst unveränderlich wären.
Verwende for...of, um die Sammlung zu durchlaufen. Änderungen am DOM während der Iteration über eine Live-Sammlung können deren Inhalt und Indizes verändern. Wenn du eine feste Zusammensetzung benötigst, erstelle zuerst mit Array.from(list) ein Array.
Beispiele
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);Ergebnis
2 1 true 2
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.