KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Arraylengte: Array.length

De eigenschap length geeft de lengte van een array aan, maar niet noodzakelijk het aantal bestaande elementen. Een toewijzing kan elementen verwijderen of de lengte vergroten zonder de nieuwe posities te vullen.

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

array.length
array.length = newLength

Array.length verwijst hier naar de eigenschap length van een array-instantie, gelezen als array.length, en niet naar de eigenschap van de Array-constructor. Het is een eigenschap, geen methode. De waarde is een geheel getal van 0 tot en met 2 ** 32 - 1.

De lengte is geen telling van bestaande elementen: een array kan lege posities bevatten. Als een toewijzing een element aanmaakt op een array-index die gelijk is aan of groter is dan de huidige lengte, wordt length verhoogd tot die index plus één. Als length niet-schrijfbaar is gemaakt, voegt zo’n toewijzing het element niet toe en wordt de array niet langer: in strict mode veroorzaakt de toewijzing een TypeError; daarbuiten mislukt ze zonder foutmelding. delete array[i] verwijdert het element als het een eigen, configureerbare eigenschap van de array is, maar verlaagt de lengte niet. Als de eigen eigenschap op die index niet configureerbaar is, blijft ze behouden: buiten strict mode geeft delete false terug, in strict mode veroorzaakt het een TypeError.

Een kleinere lengte toewijzen verwijdert eigen elementen met indices die groter dan of gelijk aan de nieuwe lengte zijn. De lengte vergroten maakt geen elementen met de waarde undefined aan, maar laat lege posities achter. In het voorbeeld stelt schrijven op index 4 de lengte in op 5; de latere verkorting naar 2 verwijdert dat element.

Als bij een toewijzing aan array.length de nieuwe lengte wordt gevalideerd, veroorzaakt een negatief getal, een breuk die geen geheel getal is, NaN, Infinity of 2 ** 32 een RangeError. Als length niet schrijfbaar is, wordt de toewijzing geweigerd zonder de nieuwe lengte te valideren: in strict mode veroorzaakt ze een TypeError; daarbuiten mislukt ze zonder foutmelding. Aanvankelijk is length schrijfbaar, niet opsombaar en niet configureerbaar. Een niet-configureerbaar element kan inkorten blokkeren: de lengte stopt bij de index ervan plus één. In strict mode veroorzaakt die toewijzing een TypeError; elementen met hogere indices kunnen dan al verwijderd zijn.

Voorbeelden

const items = [10, 20];
items[4] = 50;
console.log(items.length);
console.log(Object.hasOwn(items, 2));
items.length = 2;
console.log(JSON.stringify(items));
items.length = 4;
console.log(items.length);
console.log(Object.hasOwn(items, 2));

Resultaat

5
false
[10,20]
4
false

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