JavaScript array.flatMap() 메서드란?
JavaScript의 array.flatMap() 메서드는 중첩된(nested) 배열을 새로운 평탄화(flat)된 배열로 변환해 주는 함수입니다. 각 요소에 콜백 함수를 적용한 후, 그 결과를 한 단계 깊이까지만 평탄화하여 반환합니다.
flatMap()은 map()을 실행한 뒤 flat(1)을 호출하는 것과 동일하게 동작하지만, 두 메서드를 따로 사용할 때보다 성능 면에서 더 효율적이라는 장점이 있습니다.
기본 문법
arr.flatMap(callback(currentValue[, index[, array]])[, thisArg])
- callback: 배열의 각 요소에 대해 호출되는 함수입니다.
- thisArg: (선택 사항) 콜백 함수 실행 시
this로 사용될 값입니다.
예제 코드
다음은 array.flatMap() 메서드의 동작을 확인할 수 있는 예제 코드입니다 −
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Document</title>
<style>
body {
font-family: "Segoe UI", Tahoma, Geneva, Verdana, sans-serif;
}
.sample {
font-size: 20px;
font-weight: 500;
}
</style>
</head>
<body>
<h1>JavaScript Array flatMap()</h1>
<div class="sample"></div>
<button class="Btn">CLICK HERE</button>
<h3>
Click on the above button to convert the nested array to flat array
</h3>
<script>
let fillEle = document.querySelector(".sample");
let arr = ["cow", ["bull", "lion", "tiger"], "sheep"];
for (x of arr.entries()) {
fillEle.innerHTML += x + "<br>";
}
var entries = arr.entries();
document.querySelector(".Btn").addEventListener("click", () => {
arr = arr.flatMap((x) => x);
fillEle.innerHTML = "";
for (x of arr.entries()) {
fillEle.innerHTML += x + "<br>";
}
});
</script>
</body>
</html>
실행 결과
위 코드를 실행하면 초기 상태에서는 다음과 같이 인덱스와 함께 중첩 배열이 그대로 출력됩니다.
그런 다음 “CLICK HERE” 버튼을 클릭하면 −
버튼 클릭 후에는 flatMap((x) => x)가 각 요소를 그대로 반환하면서 내부 배열이 한 단계 풀려, 모든 요소가 하나의 평탄한 배열에 순서대로 나열된 것을 확인할 수 있습니다.
정리
flatMap()은 중첩 배열을 다룰 때 map()과 flat()을 조합하는 번거로움 없이 코드를 더 간결하고 읽기 쉽게 만들어 줍니다. 다만 기본적으로 한 단계 깊이만 평탄화하므로, 더 깊은 중첩 구조를 처리하려면 flat(depth) 메서드를 함께 활용하는 것이 좋습니다.