CKTIS / JavaScript
HTMLCollection.length — Anzahl der Elemente in einer Sammlung
HTMLCollection.length gibt die aktuelle Anzahl der Elemente in einer DOM-Sammlung zurück. Die Eigenschaft ist schreibgeschützt und wird automatisch aktualisiert, wenn sich der Inhalt der Live-Sammlung ändert.
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
collection.lengthHTMLCollection.length ist eine schreibgeschützte Eigenschaft, die eine nicht negative Ganzzahl zurückgibt: die Anzahl der Elemente in der Sammlung. Lies sie als collection.length, ohne Aufrufklammern. Eine leere Sammlung hat die Länge 0. Indizes beginnen bei 0; daher ist der letzte Index einer nicht leeren Sammlung collection.length - 1.
Eine HTMLCollection ist live: DOM-Änderungen, die ihren Inhalt beeinflussen, aktualisieren die Sammlung und ihre length automatisch. Im Beispiel enthält container.children nur direkte Kindelemente, die Elemente sind. Das Hinzufügen eines Textknotens erhöht die Anzahl nicht, das Hinzufügen eines Elements dagegen schon. Dieselbe Referenz items spiegelt auch das anschließende Entfernen des Elements wider.
Behandle eine HTMLCollection nicht wie ein Array: Eine Zuweisung an length ist keine Möglichkeit, sie zu kürzen. Ändere stattdessen die betreffenden DOM-Elemente. Beim Entfernen von Elementen während einer Iteration können sich Indizes verschieben und Einträge übersprungen werden. Wenn du solche Änderungen planst, iteriere über eine mit Array.from(collection) erstellte Kopie.
Dies ist eine Browser-DOM-API und keine Funktion einer bestimmten ECMAScript-Ausgabe. MDN kennzeichnet diese Eigenschaft seit Juli 2015 als breit in Browsern verfügbar. Dass sich Node 24 in einem Repository befindet, belegt weder die Verfügbarkeit eines DOM noch die Browserunterstützung dieser API.
Beispiele
(() => {
const container = document.createElement("div");
const items = container.children;
console.log(items.length);
container.appendChild(document.createTextNode("text"));
console.log(items.length);
const child = document.createElement("span");
container.appendChild(child);
console.log(items.length);
container.removeChild(child);
console.log(items.length);
})();Ergebnis
0 0 1 0
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.