Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Array.prototype.flat: appiattire array annidati

flat restituisce un nuovo array superficiale espandendo gli array annidati fino alla profondità richiesta.

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

Sintassi

array.flat([depth])

array.flat([depth]) crea un nuovo array ed espande gli elementi Array fino a depth, che vale 1 per default. L’argomento è troncato a intero: un valore non positivo produce una copia superficiale, Infinity l’appiattimento completo. Un oggetto array-like non Array non viene espanso.

Non muta la sorgente e le referenze agli oggetti restano condivise. I vuoti nei livelli visitati sono saltati, quindi il risultato può essere più denso. Rispetta il costruttore species; errori di getter o proxy si propagano. Un ricevente null o undefined genera TypeError. L’esempio appiattisce due livelli, elimina i vuoti e conserva la lunghezza sorgente.

Esempi

const source = [1, , [2, , [3]]];
const result = source.flat(2);
console.log(result.join(","), result.length);
console.log(source.length);

Risultato

1,2,3 3
3

Fonti