Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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 = newLength

arr.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

Fonti