flattenDepth

INFO

이 함수는 호환성을 위한 es-toolkit/compat 에서만 가져올 수 있어요. 대체할 수 있는 네이티브 JavaScript API가 있거나, 아직 충분히 최적화되지 않았기 때문이에요.

es-toolkit/compat에서 이 함수를 가져오면, lodash와 완전히 똑같이 동작해요.

배열을 지정된 깊이까지 평평하게 만듭니다.

인터페이스

function flattenDepth<T, D extends number = 1>(value: T[], depth: D): Array<FlatArray<T[], D>> | [];

파라미터

• value (T[]): 평평하게 할 값이에요.

value는 ArrayLike<T>, null, 또는 undefined가 될 수 있어요.

lodash와 완전한 호환성을 보장하기 위해, flattenDepth 함수는 value를 다음과 같이 처리해요.

• value가 ArrayLike<T>인 경우, Array.from(...)을 사용하여 배열로 변환돼요.
• value가 null 또는 undefined인 경우, 빈 배열로 처리돼요.

• depth (D): 중첩 배열 구조가 얼마나 깊게 평평해져야 하는지 지정하는 깊이 수준이에요. 기본값은 1이에요.

반환 값

(Array<FlatArray<T[], D>> | []): 평평해진 새로운 배열이에요.

예시

const arr = flattenDepth([1, [2, 3], [4, [5, 6]]], 1);
// Returns: [1, 2, 3, 4, [5, 6]]

const arr = flattenDepth([1, [2, 3], [4, [5, 6]]], 2);
// Returns: [1, 2, 3, 4, 5, 6]