Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Array.prototype.flat: aplanar arrays anidados

flat devuelve un array superficial nuevo expandiendo arrays anidados hasta la profundidad solicitada.

Versión: ECMAScript 2026 draft; example target: Node.js 24.22.2

Sintaxis

array.flat([depth])

array.flat([depth]) crea un array nuevo y expande elementos Array hasta depth; el valor predeterminado es 1. El argumento se trunca a entero: un valor no positivo produce una copia superficial e Infinity aplanado completo. Un objeto array-like que no sea Array no se expande.

No muta el origen y las referencias a objetos siguen compartidas. Los huecos de niveles visitados se omiten, por lo que el resultado puede ser más denso. Se respeta el constructor species y se propagan errores de getters o proxies. Un receptor null o undefined lanza TypeError. El ejemplo aplana dos niveles, elimina sus huecos y conserva la longitud del origen.

Ejemplos

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

Resultado

1,2,3 3
3

Fuentes