Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Lunghezza dell’array: Array.length

La proprietà length indica la lunghezza di un array, ma non necessariamente il numero di elementi esistenti. Assegnarle un valore può eliminare elementi oppure aumentare la lunghezza senza riempire le nuove posizioni.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

array.length
array.length = newLength

Array.length indica qui la proprietà length di un’istanza di array, letta come array.length, non la proprietà del costruttore Array. È una proprietà, non un metodo. Il suo valore è un numero intero compreso tra 0 e 2 ** 32 - 1 inclusi.

La lunghezza non conta gli elementi esistenti: un array può contenere posizioni vuote. Se un’assegnazione crea un elemento a un indice dell’array pari o superiore alla lunghezza attuale, length aumenta fino a quell’indice più uno. Se length è stata resa non scrivibile, un’assegnazione del genere non aggiunge l’elemento né estende l’array: in modalità strict genera un TypeError, altrimenti fallisce senza segnalare errori. delete array[i] rimuove l’elemento se è una proprietà propria e configurabile dell’array, ma non riduce la lunghezza. Se la proprietà propria a quell’indice non è configurabile, non viene rimossa: delete restituisce false al di fuori della modalità strict e genera un TypeError in modalità strict.

Assegnare una lunghezza minore elimina gli elementi propri con indici maggiori o uguali alla nuova lunghezza. Aumentarla non crea elementi con valore undefined, ma lascia posizioni vuote. Nell’esempio, la scrittura all’indice 4 imposta la lunghezza a 5, e la successiva riduzione a 2 rimuove quell’elemento.

Se un’assegnazione a array.length arriva alla verifica della nuova lunghezza, un numero negativo, una frazione non intera, NaN, Infinity o 2 ** 32 provoca un RangeError. Se length non è scrivibile, l’assegnazione viene respinta senza verificare la nuova lunghezza: in modalità strict genera un TypeError, altrimenti fallisce senza segnalare errori. Inizialmente, length è scrivibile, non enumerabile e non configurabile. Un elemento non configurabile può impedire il troncamento: la lunghezza si ferma al suo indice più uno. In modalità strict, l’assegnazione genera un TypeError e gli elementi con indici superiori potrebbero essere già stati eliminati.

Esempi

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));

Risultato

5
false
[10,20]
4
false

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti