KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

HTMLCollection.length — aantal elementen in een verzameling

HTMLCollection.length geeft het huidige aantal elementen in een DOM-verzameling terug. De eigenschap is alleen-lezen en wordt automatisch bijgewerkt wanneer de inhoud van de live verzameling verandert.

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

collection.length

HTMLCollection.length is een alleen-lezen eigenschap die een niet-negatief geheel getal teruggeeft: het aantal elementen in de verzameling. Je leest de eigenschap als collection.length, zonder aanroephaakjes. Een lege verzameling heeft lengte 0. Indexen beginnen bij 0, dus de laatste index van een niet-lege verzameling is collection.length - 1.

Een HTMLCollection is live: DOM-wijzigingen die de inhoud beïnvloeden, werken de verzameling en de eigenschap length automatisch bij. In het voorbeeld bevat container.children alleen directe kinderen die elementen zijn. Een tekstknooppunt toevoegen verhoogt het aantal niet, maar een element toevoegen wel. Dezelfde verwijzing items weerspiegelt ook de daaropvolgende verwijdering van het element.

Behandel een HTMLCollection niet als een array: een waarde toewijzen aan length is geen manier om de verzameling in te korten. Wijzig in plaats daarvan de betreffende DOM-elementen. Het verwijderen van elementen tijdens een iteratie kan indexen verschuiven en ervoor zorgen dat items worden overgeslagen. Als je zulke wijzigingen wilt uitvoeren, itereer dan over een kopie die is gemaakt met Array.from(collection).

Dit is een browser-DOM-API, geen functie van een bepaalde ECMAScript-editie. MDN vermeldt dat deze eigenschap sinds juli 2015 breed beschikbaar is in browsers. De aanwezigheid van Node 24 in een repository bewijst niet dat er een DOM beschikbaar is of dat browsers deze API ondersteunen.

Voorbeelden

(() => {
  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);
})();

Resultaat

0
0
1
0

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.

Bronnen