CKTIS / JavaScript
`length`: de schrijfbare eigenschap van een array
Lees `arr.length` om de lengte van een array op te vragen. Wijs een waarde toe om diezelfde array in te korten of te verlengen zonder elementen aan te maken.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
arr.length
arr.length = newLengtharr.length is een eigen data-eigenschap van een Array-instantie, niet de eigenschap length van de Array-constructor. De eigenschap is standaard schrijfbaar, maar niet opsombaar of configureerbaar. De waarde is groter dan elke eigen array-index en kan groter zijn dan het aantal aanwezige elementen.
Een kleinere length verwijdert eigen elementen met een index vanaf de nieuwe lengte. arr.length = 0 maakt een gewone array leeg zonder deze te vervangen: de wijziging is zichtbaar via elke verwijzing naar dezelfde array. Een grotere lengte laat lege posities achter, geen elementen met de waarde undefined, en herstelt verwijderde elementen niet. Als je een element aanmaakt op een geldige index i vanaf de huidige lengte, stijgt de lengte naar i + 1.
De lengte is een geheel getal van het type Number, van 0 tot en met 2 ** 32 - 1. Bij een toewijzing aan een schrijfbare length wordt de waarde geconverteerd: "3" wordt bijvoorbeeld geaccepteerd als 3, maar 2.5, -1 en 2 ** 32 veroorzaken een RangeError. De conversie van een Symbol of BigInt veroorzaakt daarentegen een TypeError.
Als het inkorten een niet-configureerbaar element tegenkomt, stopt het bij die index. De lengte wordt die index plus één, en al verwijderde elementen met hogere indices komen niet terug. Met writable: false kun je length ook blijvend niet-schrijfbaar maken. Dat blokkeert toewijzingen aan length en toevoegingen die de array zouden verlengen, maar niet alle wijzigingen aan elementen. In beide gevallen veroorzaakt een mislukte toewijzing in strict mode een TypeError; daarbuiten wordt geen uitzondering opgegooid.
Voorbeelden
(() => {
"use strict";
const arr = ["a", "b", "c"];
const alias = arr;
arr.length = 1;
console.log(`${alias.length}: ${alias.join(",")}`);
arr.length = 3;
arr[2] = undefined;
console.log(`${arr.length}: ${Object.hasOwn(arr, 1)}, ${Object.hasOwn(arr, 2)}`);
arr[4] = "e";
console.log(`${arr.length}: ${arr[4]}`);
try {
arr.length = 2.5;
} catch (error) {
console.log(`${error.name}: ${arr.length}`);
}
})();Resultaat
1: a 3: false, true 5: e RangeError: 5
Via `alias` zie je dat dezelfde array korter wordt. Na het verlengen onderscheidt `Object.hasOwn` de lege positie op index `1` van de expliciet toegewezen waarde `undefined` op index `2`. Schrijven op index `4` verhoogt de lengte naar `5`; de geweigerde waarde `2.5` verandert die niet.
Gerelateerde lessen
- JavaScript · Les 20 · Gevorderd · Versie: 4