HOWTO · Angular
AngularJS의 배열 매핑
AngularJS 애플리케이션에서 JavaScript의 `Array.prototype.map`을 사용해 배열 요소를 변환하는 방법과, `map`과 `filter`의 차이를 예제로 알아봅니다.
이 페이지의 내용
AngularJS 애플리케이션에서 배열 변환은 JavaScript가 담당하며, 별도의 AngularJS 매핑 기능은 없습니다. Array.prototype.map 메서드는 비어 있지 않은 각 배열 요소에 콜백을 호출하고, 콜백의 결과를 담은 새 배열을 반환합니다. 희소 배열에서는 빈 슬롯을 건너뛰고 결과에도 해당 빈 슬롯을 유지합니다. 레코드를 화면에 표시할 레이블로 바꾸는 것처럼 각 요소를 변환할 때 사용하며, 요소를 필터링하지는 않습니다.
콜백에는 현재 요소, 인덱스, 원본 배열이 전달됩니다. 보통은 요소만 사용합니다. 콜백이 반환한 값은 결과 배열의 해당 위치에 들어갑니다. 콜백이 값을 반환하지 않으면 그 위치에는 undefined가 들어가므로, 원하는 값을 만들려면 명시적으로 반환하세요. 매핑은 방문한 배열 요소의 개수와 순서를 유지하며, 조건에 맞지 않는 요소를 제거하지 않습니다.
AngularJS에서 배열 매핑이 하는 일
AngularJS에서는 컨트롤러, 서비스 또는 배열을 다루는 다른 코드에서 일반 JavaScript 배열 메서드를 사용할 수 있습니다. 연산은 items.map(callback) 형태이며, 템플릿 지시문이나 AngularJS 전용 서비스에 의존하지 않습니다. map 자체는 새 결과 배열을 만들며 원본 배열을 변경하지 않습니다. 다만 콜백은 원본 배열을 변경하거나 다른 부수 효과를 일으킬 수 있습니다. 희소 배열에서는 비어 있지 않은 요소에만 콜백이 실행되고, 빈 슬롯은 결과에도 빈 슬롯으로 남습니다. 따라서 다른 작업에 원본 레코드를 보존하면서 뷰에 표시할 데이터를 준비할 때 유용합니다.
반환되는 배열은 새 배열이지만, 그 안의 객체가 자동으로 복제되는 것은 아닙니다. 콜백이 원본 배열에 있는 객체를 반환하면 두 배열이 같은 객체를 참조할 수 있습니다. 단순한 변환을 원한다면 콜백 안에서 원본 객체를 변경하지 마세요. 별도의 객체 형태가 필요하면 새 객체를 반환하세요.
Array.prototype.map으로 각 요소 변환하기
배열에서 .map()을 호출하고 변환된 값을 반환하는 함수를 전달하세요. 예를 들어 users.map(user => user.name)은 이름 배열을 반환합니다. 화살표 함수의 표현식은 반환값이 됩니다. 블록 본문을 사용한다면 return을 명시하세요. users.map(user => { return user.name; })처럼 작성합니다. 블록 본문에서 값을 반환하지 않으면 방문한 각 요소의 결과는 undefined가 됩니다.
다음 예제를 실행해 보세요.
이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.
const tagNames = { 1: "JavaScript", 2: "AngularJS", 3: "TypeScript" };
const selectedIds = [2, 3];
const selectedNames = selectedIds.map(id => tagNames[id]);
console.log(JSON.stringify(selectedNames));
["AngularJS","TypeScript"]
여기서는 선택한 각 ID를 tagNames의 키로 사용하고, 콜백은 일치하는 레이블을 반환합니다. 결과에는 선택한 ID마다 레이블이 하나씩, 원래와 같은 순서로 들어갑니다. JSON.stringify를 사용하면 배열을 한 줄의 출력으로 쉽게 확인할 수 있습니다.
선택한 ID를 값으로 매핑하기
선택한 ID를 이름으로 바꾸는 패턴은 폼이나 컴포넌트에는 식별자가 저장되어 있지만 뷰에는 읽기 쉬운 이름을 표시해야 할 때 유용합니다. 사용 가능한 태그 레코드로 조회 객체를 만들거나 가져온 다음, 선택한 ID 배열을 그 조회 객체에 매핑하세요. 입력과 결과의 변수 이름을 구분하면 어떤 값이 식별자이고 어떤 값이 레이블인지 명확해집니다. 실제 애플리케이션에서는 이름을 중복해서 직접 관리하지 말고 데이터 소스가 제공하는 레코드에서 조회 객체를 만드세요.
조회 객체에 없는 ID가 데이터에서 어떤 의미인지도 고려하세요. 일치하는 키가 없는 조회는 undefined를 반환하므로, 렌더링 전에 이를 표시할지, 보고할지 또는 처리할지 결정해야 합니다. 결과에 레이블이 있는 ID만 포함하려면 먼저 필터링 단계에서 일치하는 ID를 고른 다음 선택된 값을 매핑하세요. 콜백의 반환값에 따라 map이 요소를 버릴 것이라고 기대하지 마세요.
map과 filter는 언제 사용할까
모든 요소가 변환된 값 하나씩 결과에 포함되어야 한다면 map을 사용하세요. 조건을 통과한 요소만 남기려면 filter를 사용합니다. 레코드를 고른 다음 변환하는 작업에는 items.filter(isVisible).map(toLabel)처럼 두 메서드를 함께 쓸 수 있습니다. 중간 배열에는 필터를 통과한 요소가 들어가고, 최종 배열에는 그 요소들의 레이블이 들어갑니다.
두 메서드 모두 자체적으로 원본 배열을 변경하지 않지만, 콜백은 원본 배열을 변경하거나 외부 상태 또는 객체를 수정하는 등의 부수 효과를 일으킬 수 있습니다. 단순한 변환을 원한다면 콜백이 값을 반환하는 데 집중하도록 하세요. 속성 하나를 추출할 때는 map을 바로 사용하고, 조건에 맞는 일부 요소만 필요하면 먼저 필터링하세요. 선택과 변환이 모두 필요하다면 두 메서드를 이 순서로 사용합니다.
JavaScript의 Map 컬렉션은 Array.prototype.map와 다른 기능입니다. set, get, has, delete, clear 같은 연산과 size 속성은 Map 객체에 속합니다. 배열 매핑 메서드가 아닙니다. 소문자로 쓴 .map() 호출은 배열 요소를 변환하며, 키-값 컬렉션을 만들거나 갱신하지 않습니다.