flat

撰写时间：2024-03-15

最新修订：2024-03-15

flat

将数组展平为指定维数的新数组并予以返回。原数组不受影响。

原型

*[]flat

numberdepth = 1

参数

depth = 1: 指定要展平的深度。默认为1。

返回值

返回展平后的新数组。

说明

flat方法将数组展平为depth所指定的维数的新数组并予以返回。

原数组不受影响。

例子

普通用法

let arr = [1, 2, 3, [4, 5], 6]; let newArr = arr.flat(); console.log(newArr); /* [1, 2, 3, 4, 5, 6] */ console.log(arr); /* [1, 2, 3, [4, 5], 6] */

指定展开的维度

let arr = [ 1, 2, 3, [ 4, [7, 8, 9], 5 ], 6 ]; let newArr1 = arr.flat(1); console.log(newArr1); /* [1, 2, 3, 4, [7, 8, 9], 5, 6] */ let newArr2 = arr.flat(2); console.log(newArr2); /* [1, 2, 3, 4, 7, 8, 9, 5, 6] */

arr是一个有3级深度的嵌套数组。

newArr1展平为1级。

newArr2展平为为2级。

参见

flatMap

参考资源

ECMA 262: Array Objects