03 고급 타입
3.2 타입 조합
1. 교차 타입(Intersection)
교차 타입을 사용하면 여러 가지 타입을 결합하여 하나의 단일 타입으로 만들 수 있다.
기존에 존재하는 다른 타입들을 합쳐서 해당 타입의 모든 멤버를 가지는 새로운 타입을 생성하는 것이다.
교차 타입은 &을 사용해서 표기한다.
예를 들어, 타입 C가 타입 A와 B의 교차 타입 즉, A & B라면 타입 C는 타입 A와 타입 B의 모든 멤버를 가지고 있는 타입이다.
type ProductItem = {
id: number;
name: string;
type: string;
price: number;
imageUrl: string;
quantity: number;
}
type ProductItemWithDiscount = ProductItem & { discountAmount: number }
// ProductItem의 모든 멤버와 discountAmount까지 멤버로 가지게 된다.
2. 유니온 타입(Union)
유니온 타입은 타입 A 또는 타입 B 중 하나가 될 수 있는 타입을 말하며 A | B같이 표기한다.
주로 특정 변수가 가질 수 있는 타입을 전부 나열하는 용도로 사용된다.
type CardItem = {
id: number;
name: string;
type: string;
imageUrl: string;
}
type PromotionEventItem = ProductItem | CardItem
const printPromotionItem = (item: PromotionEventItem) => {
console.log(item.name)
console.log(item.quantity)
// Error: Property 'quantity' does not exist on type 'PromotionEventItem'.
// Property 'quantity' does not exist on type 'CardItem'.
}
printPromotionItem() 함수를 보면 인자로 PromotionEventItem 타입을 받고 있다.
해당 함수 내부에서 quantity를 참조하려고 시도하면 컴파일 에러가 발생하는데, 이는 quantity가 ProductItem에만 존재하기 때문이다.
PromotionEventItem은 CardItem도 포함하는데 CardItem은 quantity 멤버를 가지고 있지 않기 때문에 PromotionEventItem에서는 quantity를 참조할 수 없다.
참고로 교차 타입과 유니온 타입은 여러 줄에 걸쳐 표기할 수도 있는데, 이럴 경우에는 각 줄의 맨 앞에 & 혹은 |를 붙여서 표기하면 된다.
type PromotionEventItem =
| ProductItem
| CardItem
3. 인덱스 시그니처(Index Signatures)
인덱스 시그니처는 특정 타입의 속성 이름은 알 수 없지만 속성값의 타입을 알고 있을 때 사용하는 문법이다.
인터페이스 내부에 [Key: K]: T 꼴로 타입을 명시해주면 되는데 이는 해당 타입의 속성 키는 모두 K 타입이어야 하고 속성값은 모두 T 타입을 가져야 한다는 의미다.
interface IndexSignatureEx {
[key: string]: number;
}
인덱스 시그니처를 선언할 때 다른 속성을 추가로 명시해줄 수 있는데 이때 추가로 명시된 속성은 인덱스 시그니처에 포함되는 타입이어야 한다.
interface IndexSignatureEx2 {
[key: string]: number | boolean;
length: number;
isValid: boolean;
name: string; // 에러 발생
}
4. 인덱스드 엑세스 타입(Indexed Access Types)
인덱스드 엑세스 타입은 다른 타입의 특정 속성이 가지는 타입을 조회하기 위해 사용된다.
인덱스에 사용되는 타입 또한 그 자체로 타입이기 때문에 유니온 타입, keyof, 타입 별칭 등의 표현을 사용할 수 있다.
type Example = {
a: number;
b: string;
c: boolean;
}
type IndexedAccess = Example['a']
type IndexedAccess2 = Example['a' | 'b'] // number | string
type IndexedAccess3 = Example[keyof Example] // number | string | boolean
type ExAlias = 'b' | 'c'
type IndexedAccess4 = Example[ExAlias] // string | boolean
또한 배열의 요소 타입을 조회하기 위해 인덱스드 액세스 타입을 사용하는 경우가 있다.
배열 타입의 모든 요소는 전부 동일한 타입을 가지며 배열의 인덱스는 숫자 타입이다.
따라서 number로 인덱싱하여 배열 요소를 얻은 다음에 typeof 연산자를 붙여주면 해당 배열 요소의 타입을 가져올 수 있다.
const PromotionList = [
{ type: 'product', name: 'chicken' },
{ type: 'product', name: 'pizza' },
{ type: 'card', name: 'cheer-up' },
]
type ElementOf<T> = typeof T[number]
type PromotionItemType = ElementOf<PromotionList>
// type PromotionItemType = { type: string; name: string }
5. 맵드 타입(Mapped Types)
맵드 타입은 다른 타입을 기반으로 한 타입을 선언할 때 사용하는 문법인데, 인덱스 시그니처 문법을 사용해서 반복적인 타입 선언을 효과적으로 줄일 수 있다.
type Example = {
a: number;
b: string;
c: boolean;
}
type Subset<T> = {
[K in keyof T]?: T[K];
}
const aExample: Subset<Example> = { a: 3 }
const bExample: Subset<Example> = { b: 'hello' }
const acExample: Subset<Example> = { a: 4, c: true }
맵드 타입에서 매핑할 때는 readonly와 ?를 수식어로 적용할 수 있다.
readonly는 읽기 전용으로 만들고 싶을 때 붙여주는 수식어이고, ?는 선택적 매개변수(옵셔널 파라미터)로 만들고 싶을 때 붙여주는 수식어이다.
맵드 타입의 특이한 점은 이러한 수식어를 더해주는 것뿐만 아니라 제거할 수도 있다는 것이다.
기존 타입에 존재하던 readonly나 ? 앞에 -를 붙여주면 해당 수식어를 제거한 타입을 선언할 수 있다.
type ReadOnlyEx = {
readonly a: number;
readonly b: string;
}
type CreateMutable<Type> = {
-readonly [Property in keyof Type]: Type[Property];
}
type ResultType = CreateMutable<ReadOnlyEx> // { a: number; b: string }
type OptionalEx = {
a?: number;
b?: string;
c: boolean;
}
type Concrete<Type> = {
[Property in keyof Type]-?: Type[Property];
}
type ResultType = Concrete<OptionalEx> // { a: number; b: string; c: boolean }
맵드 타입이 실제로 사용된 예시를 살펴보자.
배달의민족 선물하기 서비스에는 ‘바텀시트’라는 컴포넌트가 존재한다.
밑에서부터 스르륵 올라오는 모달이라고 생각하면 되는데 이 바텀시트는 선물하기 서비스의 최근 연락처 목록, 카드 선택, 상품 선택 등 여러 지면에서 사용되고 있다.
바텀시트마다 각각 resolver, isOpened 등의 상태를 관리하는 스토어가 필요한데 이 스토어의 타입(BottomSheetStore)을 선언해줘야 한다.
이때 BottomSheepMap에 존재하는 모든 키에 대해 일일이 스토어를 만들어줄 수도 있지만 불필요한 반복이 발생하게 된다.
이럴 때는 인덱스 시그니처 문법을 사용해서 BottomSheepMap을 기반으로 각 키에 해당하는 스토어를 선언할 수 있다.
이처럼 반복 작업을 효율적으로 처리할 수 있다.
const BottomSheepMap = {
RECENT_CONTACTS: RecentContactsBottomSheet,
CARD_SELECT: CardSelectBottomSheet,
SORT_FILTER: SortFilterBottomSheet,
// ...
}
export type BOTTOM_SHEET_ID = keyof typeof BottomSheepMap
type BottomSheetStore = {
[index in BOTTOM_SHEET_ID]: {
resolver?: (payload: any) => void;
args?: any;
isOpened: boolean;
}
}
덧붙여 맵드 타입에서는 as 키워드를 사용하여 키를 재지정할 수 있다.
모든 키에 _BOTTOM_SHEET를 붙이는 식으로 공통된 처리를 적용하여 새로운 키를 지정하고 싶을 수도 있다.
이럴 때는 아래 예시처럼 as 키워드를 사용해서 효율적으로 처리할 수 있다.
type BottomSheetStore = {
[index in BOTTOM_SHEET_ID as `${index}_BOTTOM_SHEET`]: {
resolver?: (payload: any) => void;
args?: any;
isOpened: boolean;
}
}
6. 템플릿 리터럴 타입(Template Literal Types)
템플릿 리터럴 타입은 자바스크립트의 템플릿 리터럴 문자열을 사용하여 문자열 리터럴 타입을 선언할 수 있는 문법이다.
위에서 본 BottomSheepMap의 각 키에다 _BOTTOM_SHEET를 붙여주는 예시가 바로 템플릿 리터럴 타입을 활용한 것이다.
조금 더 간단한 활용 예시를 살펴보자.
type Stage =
| 'init'
| 'select-image'
| 'edit-image'
| 'decorate-card'
| 'capture-image';
type StageName = `${Stage}-stage`;
// 'init-stage' | 'select-image-stage' | 'edit-image-stage' | 'decorate-card-stage' | 'capture-image-stage'
Stage 타입의 모든 유니온 멤버 뒤에 -stage를 붙여서 새로운 유니온 타입을 만들었다.
7. 제네릭(Generic)
제네릭의 사전적 의미를 찾아보면 특징이 없거나 일반적인 것(net specific, general)을 뜻한다.
타입스크립트의 제네릭도 이와 비슷한 맥락을 가지고 있는데 한마디로 일반화된 데이터 타입이라고 할 수 있다.
함수, 타입, 클래스 등에서 내부적으로 사용할 타입을 미리 정해두지 않고 타입 변수를 사용해서 해당 위치를 비워 둔 다음에, 실제로 그 값을 사용할 때 외부에서 타입 변수 자리에 타입을 지정하여 사용하는 방식을 말한다.
이렇게 하면 함수, 타입, 클래스 등 여러 타입에 대해 하나하나 따로 정의하지 않아도 되기 때문에 재사용성이 크게 향상된다.
타입 변수는 일반적으로
보통 타입 변수명으로 T(Type), E(Element), K(Key), V(Value) 등 한 글자로 된 이름을 많이 사용한다.
type ExampleArrayType<T> = T[]
const array1: ExampleArrayType<string> = ['치킨', '피자', '우동']
제네릭은 any처럼 아무 타입이나 무분별하게 받는 게 아니라, 배열 생성 시점에 원하는 타입으로 특정할 수 있다.
다시 말해 제네릭을 사용하면 배열 요소가 전부 동일한 타입이라고 보장할 수 있다.
참고로 제네릭 함수를 호출할 때 반드시 꺾쇠괄호(<>) 안에 타입을 명시해야 하는 것은 아니다.
타입을 명시하는 부분을 생략하면 컴파일러가 인수를 보고 타입을 추론해준다.
또한 특정 요소 타입을 알 수 없을 때는 제네릭 타입에 기본값을 추가할 수 있다.
interface SubmitEvent<T = HTMLElement> extends SyntheticEvent<T> { submitter: T }