Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Array.from: array da iterabile o oggetto array-like

Array.from crea un nuovo array da un iterabile o da un oggetto indicizzato array-like e può trasformare i valori durante la costruzione.

Versione: ECMAScript 2026 draft; example target: Node.js 24.22.2

Sintassi

Array.from(items[, mapFn[, thisArg]])

Array.from(items, mapFn, thisArg) usa il protocollo di iterazione se items offre un iteratore; altrimenti legge length e le proprietà indicizzate. Restituisce sempre un risultato nuovo. mapFn(value, index) opera durante la creazione e thisArg fornisce il relativo this.

Un indice mancante viene letto come undefined, quindi il risultato è denso. Per le stringhe l’iteratore avanza per code point Unicode e gestisce meglio le coppie surrogate. null o undefined falliscono; un mapFn fornito ma non invocabile genera TypeError. Un altro primitivo senza iteratore può essere trattato come array-like di lunghezza zero e produrre un array vuoto; gli errori dell’iteratore fornito si propagano.

La funzione è generica rispetto al costruttore usato come this, mentre la chiamata normale crea un Array. La lunghezza array-like è limitata all’intervallo intero sicuro. L’esempio mostra un indice mancante e il mapping senza array intermedio.

Esempi

const source = {0: "a", 2: "c", length: 3};
const result = Array.from(source, (value, index) => value ?? `gap${index}`);
console.log(result.join("|"));
console.log(result !== source);

Risultato

a|gap1|c
true

Fonti