跳到主要内容

flatten()

function flatten<T>(array): T[];

Defined in: array/flatten.ts:24

将嵌套一层的数组扁平化为一维数组 仅处理数组中的直接嵌套数组元素,不进行深度扁平化

Type Parameters

Type ParameterDescription
T数组元素的基础类型

Parameters

ParameterTypeDescription
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:** 非数组元素会被直接包含在结果中