CKTIS / JavaScript
NodeList.length — Anzahl der Knoten
NodeList.length ist eine schreibgeschützte Eigenschaft, die die Anzahl der Knoten in einer Sammlung angibt – nicht unbedingt nur die Anzahl der Elemente.
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
nodeList.lengthNodeList.length gibt die Anzahl der Knoten in der Sammlung als nichtnegative ganze Zahl zurück. Bei einer leeren Sammlung ist der Wert 0. Die Eigenschaft ist schreibgeschützt und keine Methode: Verwende nodeList.length ohne Klammern. Die Indizes beginnen bei 0 und enden bei length - 1.
Der Wert hängt von der Sammlung ab. childNodes enthält auch Text- und Kommentarknoten. Diese Sammlung ist live, daher spiegelt ihre Länge Änderungen am DOM wider. querySelectorAll() gibt eine statische Sammlung zurück: Spätere Änderungen am DOM aktualisieren ihre Länge nicht.
Dies ist eine DOM-API und kein Sprachmerkmal von ECMAScript. Das Beispiel zeigt beide Sammlungen anhand eines nicht in das Dokument eingefügten Elements.
Beispiele
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);Ergebnis
2 1 3 1
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.