# JavaScript flat 提取嵌套数组元素

> flat() 方法会按照一个可指定的深度递归遍历数组，并将所有元素与遍历到的子数组中的元素合并为一个新数组返回。

Author: DeathGhost
Published: 2019-08-07 00:57:27
Category: javascript
Canonical: https://www.deathghost.cn/article/javascript/56
Keywords: JavaScript, flat, 数组, 合并, 数组合并, 数组嵌套, 多维数组, 展开数组, 数组一级展开, 数组扁平化

对于前端项目开发过程中偶尔会出现层叠数据结构的数组，我们需要将多层级数组转换为一级数组（即：提取嵌套数组元素最终合并为一个数组），使其内容合并且展开。

e.g. ['延安', ['西安', '咸阳']] 一般，我们使用传统方式处理，可能相对来说比较麻烦；下面看看新方法操作。

![Array.prototype.flat()](https://www.deathghost.cn/public/upload/article/2019/08/1565110579938.jpg)

JavaScript flat 提取嵌套数组元素

语法

let newArray = arr.flat(depth)
参数

depth （可选参数）指定要提取嵌套数组的结构深度，默认值为 1。

示例

let city = ['延安', ['西安', '咸阳']];
city.flat(1)
OR
city.flat()
上述则输出结果为：["延安", "西安", "咸阳"]

那如果我们再对其嵌套数组呢？

let city = ['延安', ['西安', '咸阳', ['渭南'], ['宝鸡']]];
0: "延安"
1: "西安"
2: "咸阳"
3: ["渭南"]
4: ["宝鸡"]
按上述则会： ["延安", "西安", "咸阳", Array(1), Array(1)] 一般。

那么，我们就需要设置depth的嵌套层数。

city.flat(2)
则输出：

["延安", "西安", "咸阳", "渭南", "宝鸡"]
如果其嵌套层级深度不确定呢？

那么我们就可以直接使用 Infinity /ɪnˈfɪnəti]/ 作为深度，展开任意深度的嵌套数组。

let city = ['延安', ['西安', '咸阳', ['渭南'], ['宝鸡']]];
console.log(city.flat(Infinity));
我想知道为什么默认参数不是 Infinity 呢？

## Related

- Previous: [通过 Web API Vibration 触发移动端物理振动](https://www.deathghost.cn/article/javascript/55)
- Next: [JS原生的深拷贝API structuredClone()](https://www.deathghost.cn/article/javascript/120)