Array.prototype.flat()的核心作用是数组降维,将嵌套数组按指定深度展开为一维数组,从而让深层原始值“浮出水面”;它不转换或过滤元素,仅清除数组外壳,返回新数组。

Array.prototype.flat() 的核心作用是“降维”,但它本身不负责提取原始类型(如字符串、数字、布尔值等),而是把嵌套数组结构打平成一维数组。原始类型的提取,是在扁平化之后自然发生的——因为扁平后的数组元素中,原本被包裹在深层数组里的原始值就直接暴露出来了。
flat() 如何让原始值“浮出水面”
嵌套数据中,原始类型往往藏在多层数组或混合结构里。调用 flat() 后,所有子数组被递归展开(按指定深度),最终只剩最外层一个数组,其中每个元素都是不再被数组包裹的值——也就是你想要的原始类型(或对象、函数等非数组值)。
- 默认只展开一层:
[1, [2, [3]]].flat()→[1, 2, [3]](3还在数组里,没被提取) - 传入
Infinity深度可彻底打平:[1, [2, [3, [4]]]].flat(Infinity)→[1, 2, 3, 4],所有数字都成了顶层原始值 - 对含空槽或
undefined的数组也有效:[1, , [2, undefined]].flat()→[1, 2, undefined]
注意:flat() 不过滤、不转换,只展开
它不会自动跳过对象、null 或函数,也不会把字符串数字转成数字。所谓“提取原始类型”,其实是你后续操作的事——flat() 只负责清除数组外壳,把值推到第一层。
-
['a', ['b', {c: 1}], [null, true]].flat(Infinity)→['a', 'b', {c: 1}, null, true](字符串、布尔、null、对象并存) - 若只想保留原始类型,需配合
filter()和typeof:arr.flat(Infinity).filter(v => typeof v === 'string' || typeof v === 'number' || typeof v === 'boolean')
与 flatMap() 配合实现“边展平边提取”
如果嵌套结构不规则(比如有些项是数组、有些是原始值、还有些是 null),单独用 flat() 可能不够灵活。flatMap() 允许你先映射再扁平,更适合做预处理:
-
[1, [2, 3], null, 'hello'].flatMap(x => Array.isArray(x) ? x : [x])→[1, 2, 3, null, 'hello'] - 想跳过 null/undefined 并提取原始值:
data.flatMap(x => x == null ? [] : (Array.isArray(x) ? x : [x])).filter(x => x !== null && x !== undefined)
常见陷阱提醒
别误以为 flat() 能处理类数组、Set、Map 或普通对象——它只对数组有效。遇到 NodeList 或 arguments,得先转成数组;遇到对象字段嵌套,得先用 Object.values() 或递归提取数组部分。
-
Array.from(document.querySelectorAll('div')).flat()✅(先转数组) -
Object.values({a: [1], b: [2, 3]}).flat()✅(取值后再扁平) -
new Set([1, [2, 3]]).flat()❌(Set 没有 flat 方法)

















