Array.prototype.flat() 메서드란?
JavaScript의 Array.prototype.flat() 메서드는 중첩된 배열을 지정한 깊이(depth)까지 재귀적으로 평탄화(flatten)하여 새로운 배열을 생성하고 반환합니다. 이 메서드는 원본 배열을 절대 변경하지 않고, 항상 새로운 배열을 돌려준다는 점이 특징입니다.
기본 깊이 값은 1이며, 인자로 Infinity를 전달하면 중첩된 모든 레벨의 배열을 한 번에 펼칠 수 있습니다.
주요 특징
- 원본 배열을 수정하지 않고 새 배열을 반환합니다.
- 깊이 값을 생략하면 기본값인 1이 적용됩니다.
Infinity를 사용하면 모든 중첩 구조가 완전히 평탄화됩니다.- 배열 내부의 빈 슬롯(hole)도 함께 제거할 수 있습니다.
예제 코드
다음은 Array.prototype.flat() 메서드를 사용해 깊이 1만큼 배열을 평탄화하는 전체 예제입니다.
<!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;
}
.result,.sample {
font-size: 20px;
font-weight: 500;
}
</style>
</head>
<body>
<h1>Array.prototype.flat() 메서드</h1>
<div class="sample"><pre>[1,2,3,[4,5],[6,[7,8]]]</pre></div>
<div style="color: green;" class="result">평탄화 후 : <br></div>
<button class="Btn">여기를 클릭하세요</button>
<h3>위 버튼을 클릭하면 배열이 깊이 1로 평탄화됩니다</h3>
<script>
let resEle = document.querySelector(".result");
let sampleEle = document.querySelector(".sample");
let arr = [1,2,3,[4,5],[6,[7,8]]];
document.querySelector(".Btn").addEventListener("click", () => {
let store = arr.flat(1);
store.forEach((item,index) => {
resEle.innerHTML += index + ' : ' + item + '<br>';
});
});
</script>
</body>
</html>
실행 결과
위 코드를 실행하면 다음과 같은 초기 화면이 표시됩니다.
버튼을 클릭하면 깊이 1로 평탄화된 배열의 요소들이 인덱스 번호와 함께 순서대로 출력됩니다.
