flatten()
function flatten<T>(array): T[];
Defined in: array/flatten.ts:24
将嵌套一层的数组扁平化为一维数组 仅处理数组中的直接嵌套数组元素,不进行深度扁平化
Type Parameters
| Type Parameter | Description |
|---|---|
T | 数组元素的基础类型 |
Parameters
| Parameter | Type | Description |
|---|---|---|
array | (T | T[])[] | 输入数组,包含基础类型元素和/或嵌套一层的数组 |
Returns
T[]
扁平化后的新数组,所有元素均为基础类型T
Examples
flatten([1, [2, 3], 4]);
// 返回 [1, 2, 3, 4]
flatten(['a', ['b', ['c']], 'd']);
// 返回 ['a', 'b', ['c'], 'd'] (仅扁平化一层,保留深层嵌套数组)
flatten([[], [1, 2], 3]); // 返回 [1, 2, 3] (处理空数组)
flatten([1, 2, 3]); // 返回 [1, 2, 3] (无嵌套数组时返回原数组元素)
flatten([]); // 返回 [] (空输入数组)
**Note:** 与flattenDeep的区别:此函数仅扁平化一层,而flattenDeep会递归扁平化所有层级
**Note:** 函数返回新数组,不会修改原输入数组
**Note:** 非数组元素会被直接包含在结果中