객체 구조 정의와 타입 안전성을 확보하는 TypeScript의 Record 타입 살펴보기

Record 타입의 정의

`Record` 타입은 두 개의 제네릭 타입 매개변수를 받습니다:

• 첫 번째 매개변수는 키의 타입 (`K`)입니다.
• 두 번째 매개변수는 값의 타입 (`T`)입니다.

즉, `Record<K, T>`는 키 타입 `K`와 값 타입 `T`를 가지는 객체 타입을 정의합니다. 이를 통해 객체의 키와 값의 타입을 명확하게 지정할 수 있습니다.

기본 사용법

type ButtonSize = 'small' | 'medium' | 'large';

const gapMap: Record<ButtonSize, number> = {
  small: 5,
  medium: 10,
  large: 15
};

위의 예제에서는 `ButtonSize` 타입이 `small`, `medium`, `large` 문자열 중 하나를 가질 수 있도록 정의되어 있습니다. `gapMap` 객체는 `ButtonSize` 타입을 키로 가지며, 값은 모두 숫자 타입입니다. 이를 통해 `gapMap` 객체의 구조를 명확하게 정의할 수 있습니다.

복잡한 타입의 값

`Record` 타입은 값으로 복잡한 타입을 가질 수도 있습니다.

type UserRole = 'admin' | 'user' | 'guest';
type UserInfo = { name: string; age: number };

const userMap: Record<UserRole, UserInfo> = {
  admin: { name: 'Alice', age: 30 },
  user: { name: 'Bob', age: 25 },
  guest: { name: 'Charlie', age: 20 }
};

위의 예제에서는 `UserRole` 타입을 키로, `UserInfo` 타입을 값으로 가지는 객체를 정의하고 있습니다. 이렇게 하면 각 사용자 역할에 대한 정보를 명확하게 지정할 수 있습니다.

Record 타입의 장점

• 타입 안정성: 객체의 키와 값 타입을 명확하게 정의하여 타입 안정성을 보장합니다.
• 코드 가독성: 타입 정의를 통해 코드의 가독성을 높여줍니다.
• 자동 완성: IDE에서 키와 값 타입에 대한 자동 완성 기능을 활용할 수 있습니다.

주의사항

• `Record` 타입의 키는 반드시 문자열, 숫자, 심볼 중 하나여야 합니다.
• 값의 타입이 복잡해질수록 타입 정의도 복잡해질 수 있으므로, 필요한 경우 별도의 타입을 정의하여 가독성을 높이는 것이 좋습니다.

실전 예제

좀 더 실전적인 예제를 통해 `Record` 타입의 활용을 살펴보겠습니다.

type ApiResponseStatus = 'success' | 'error' | 'loading';
type ApiResponse = { status: ApiResponseStatus; data?: any; error?: string };

const apiResponseMap: Record<string, ApiResponse> = {
  userFetch: { status: 'loading' },
  userFetchSuccess: { status: 'success', data: { name: 'John', age: 35 } },
  userFetchError: { status: 'error', error: 'User not found' }
};

이 예제에서는 `apiResponseMap` 객체가 다양한 API 응답 상태를 관리합니다. 각 키는 특정 API 요청의 상태를 나타내고, 값은 `ApiResponse` 타입을 따릅니다. 이를 통해 API 응답 상태를 체계적으로 관리하고, 타입 안전성을 보장할 수 있습니다.

결론

TypeScript의 `Record` 타입은 특정 키-값 쌍의 구조를 정의하고, 타입 안정성을 높이는 데 매우 유용한 도구입니다. 객체의 구조를 명확하게 정의하고, 코드의 가독성을 높이며, IDE의 자동 완성 기능을 통해 개발 효율성을 향상시킬 수 있습니다. 다양한 실전 예제를 통해 `Record` 타입을 활용하여 더욱 견고하고 유지보수 가능한 코드를 작성해보세요.

TypeScript를 활용한 더 많은 예제와 심화 학습을 원하신다면, 공식 문서와 다양한 커뮤니티 리소스를 참고하시길 추천드립니다. TypeScript의 강력한 타입 시스템을 통해 개발 생산성을 극대화하고, 안정적인 코드를 작성하는 데 큰 도움을 받을 수 있을 것입니다.