CKTIS / JavaScript
`length`: la proprietà scrivibile di un array
Leggi `arr.length` per ottenere la lunghezza dell’array oppure assegnale un valore per accorciare lo stesso array o allungarlo senza creare elementi.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
arr.length
arr.length = newLengtharr.length è una proprietà dati propria di un’istanza di Array, non la proprietà length del costruttore Array. Inizialmente è scrivibile, ma non è enumerabile né configurabile. Il suo valore è maggiore di ogni indice proprio dell’array e può superare il numero di elementi presenti.
Ridurre length elimina gli elementi propri il cui indice è maggiore o uguale alla nuova lunghezza. arr.length = 0 svuota un array ordinario senza sostituirlo: la modifica è visibile da ogni riferimento allo stesso array. Aumentare la lunghezza lascia posizioni vuote, non elementi con valore undefined, e non ripristina quelli eliminati. Creare un elemento a un indice valido i maggiore o uguale alla lunghezza corrente la porta a i + 1.
La lunghezza è un intero di tipo Number compreso tra 0 e 2 ** 32 - 1, estremi inclusi. Quando length è scrivibile, il valore assegnato viene convertito: per esempio, "3" è accettato come 3, ma 2.5, -1 e 2 ** 32 causano un RangeError. Convertire un Symbol o un BigInt causa invece un TypeError.
Se durante l’accorciamento si incontra un elemento non configurabile, l’operazione si ferma al suo indice. La lunghezza diventa quell’indice più uno, e gli elementi con indice superiore già eliminati non vengono ripristinati. Con writable: false puoi anche rendere length non scrivibile in modo permanente. Questo impedisce le assegnazioni a length e le aggiunte che allungherebbero l’array, ma non tutte le modifiche agli elementi. In entrambi i casi, un’assegnazione non riuscita causa un TypeError in modalità strict; fuori da tale modalità non genera eccezioni.
Esempi
(() => {
"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}`);
}
})();Risultato
1: a 3: false, true 5: e RangeError: 5
`alias` mostra che è lo stesso array ad accorciarsi. Dopo l’allungamento, `Object.hasOwn` distingue la posizione vuota all’indice `1` dal valore `undefined` assegnato esplicitamente all’indice `2`. La scrittura all’indice `4` porta la lunghezza a `5`; il valore `2.5` viene rifiutato senza cambiarla.
Lezioni correlate
- JavaScript · Lezione 20 · Avanzato · Versione: 4