Método flat

El método flat reduce el nivel de anidamiento de un array multidimensional. Puede convertir el array en unidimensional, o reducir la dimensionalidad en un valor especificado.

Sintaxis

let newArray = array.flat(nivel_de_profundidad);

Ejemplo

Obtengamos un nuevo array sin especificar ningún valor en el parámetro:

let arr = ['a', 'b', ['c', 'd']];
let res = arr.flat();

console.log(res);

Como resultado de ejecutar el código veremos que los subarrays se elevaron un nivel:

['a', 'b', 'c', 'd']

Ejemplo

Ahora apliquemos el método flat a un array con dos niveles de anidamiento:

let arr = ['a', 'b', ['c', 'd', ['e', 'f']]];
let res = arr.flat();

console.log(res);

Resultado de ejecutar el código:

['a', 'b', 'c', 'd', ['e', 'f']]

Ejemplo

Especifiquemos el nivel de anidamiento:

let arr = ['a', 'b', ['c', 'd', ['e', 'f']]];
let res = arr.flat(2);

console.log(res);

Resultado de ejecutar el código:

['a', 'b', 'c', 'd', 'e', 'f']

Ejemplo

Si no queremos preocuparnos por el nivel de anidamiento, y simplemente queremos aplanar todo el array, usamos el parámetro Infinity:

let arr = ['a', 'b', ['c', 'd', ['e', 'f', ['g', 'h', ['i']]]]];
let res = arr.flat(Infinity);

console.log(res);

Resultado de ejecutar el código:

[
	'a', 'b', 'c',
	'd', 'e', 'f',
	'g', 'h', 'i'
]

Véase también

método flatMap,
que devuelve un array de elementos después de aplicar una función