05 타입 활용하기

5.4 불변 객체 타입으로 활용하기

프로젝트를 진행하면서 상숫값을 관리할 때 객체를 사용한다.

예를 들어 프로젝트의 전체적인 스타일을 관리하는 theme 객체, 자주 사용하는 애니메이션을 모아둔 객체, 상숫값을 담은 객체 등 다양한 곳에서 활용되고 있다.

컴포넌트나 함수에서 이런 객체를 사용할 때 열린 타입으로 설정할 수 있다.

함수 인자로 키를 받아서 value를 반환하는 함수를 보자.

키 타입을 해당 객체에 존재하는 키값으로 설정하는 것이 아니라 string으로 설정하면 getColorHex 함수의 반환 값은 any가 된다.

colors에 어떤 값이 추가될지 모르기 때문이다.

const colors = {
  red: '#F45452',
  green: '#0C952A',
  blue: '#1A7CFF',
}

const getColorHex = (key: string) => colors[key]
// Error: Element implicitly has an 'any' type because expression of type 'string' can't be used to index type '{ red: string; green: string; blue: string; }'.
// Error: No index signature with a parameter of type 'string' was found on type '{ red: string; green: string; blue: string; }'.

여기서 as const 키워드로 객체를 불변 객체로 선언하고, keyof 연산자를 사용하여 getColorHex 함수 인자로 실제 colors 객체에 존재하는 키값만 받도록 설정할 수 있다.

keyof, as const로 객체 타입을 구체적으로 설정하면 타입에 맞지 않는 값을 전달할 경우 타입 에러가 반환되기 때문에 컴파일 단계에서 발생할 수 있는 실수를 방지할 수 있다.

또한 자동 완성 기능을 통해 객체에 어떤 값이 있는지 쉽게 파악할 수 있게 된다.

const colors = {
  red: '#F45452',
  green: '#0C952A',
  blue: '#1A7CFF',
} as const

type ColorKeyType = keyof typeof colors

const getColorHex = (key: ColorKeyType) => colors[key]

1. Atom 컴포넌트에서 theme style 객체 활용하기

Atom 단위의 작은 컴포넌트(Button, Header, Input 등)는 폰트 크기, 폰트 색상, 배경 색상 등 다양한 환경에서 유연하게 사용될 수 있도록 구현되어야 하는데 이러한 설정값은 props로 넘겨주도록 설계한다.

props로 직접 색상 값을 넘겨줄 수도 있지만 그렇게 하면 사용자가 모든 색상 값을 인지해야 하고, 변경 사항이 생길 때 직접 값을 넣은 모든 곳을 찾아 수정해야 하는 번거로움이 생기기 때문에 변경에 취약한 상태가 된다.

이런 문제를 해결하기 위해 대부분의 프로젝트에서는 해당 프로젝트의 스타일 값을 관리해주는 theme 객체를 두고 관리한다.

Atom 컴포넌트에서는 theme 객체의 색상, 폰트 사이즈의 키값을 props로 받은 뒤 theme 객체에서 값을 받아오도록 설계한다.

타입스크립트 keyof 연산자로 객체의 키값을 타입으로 추출하기

타입스크립트에서 keyof 연산자는 객체 타입을 받아 해당 객체의 키값을 string 또는 number의 리터럴 유니온 타입을 반환한다.

객체 타입으로 인덱스 시그니처가 사용되었다면 keyof는 인덱스 시그니처의 키 타입을 반환한다.

type ColorType = {
  red: string;
  green: string;
  blue: string;
}

type ColorKeyType = keyof ColorType; // 'red' | 'green' | 'blue'

타입스크립트 typeof 연산자로 값을 타입으로 다루기

keyof 연산자는 객체 타입을 받는다.

따라서 객체의 키값을 타입으로 다루려면 값 객체를 타입으로 변환해야 한다.

이때 타입스크립트의 typeof 연산자를 활용할 수 있다.

자바스크립트에서는 typeof가 타입을 추출하기 위한 연산자로 사용된다면, 타입스크립트에서는 typeof가 변수 혹은 속성의 타입을 추론하는 역할을 한다.

const colors = {
  red: '#F45452',
  green: '#0C952A',
  blue: '#1A7CFF',
}

type ColorsType = typeof colors

/**
type ColorsType = {
  red: string;
  green: string;
  blue: string;
}
*/

객체의 타입을 활용해서 컴포넌트 구현하기

keyof, typeof 연산자를 사용해서 theme 객체 타입을 구체화하고, string으로 타입을 설정했던 Button 컴포넌트를 개선해보자.

color, backgroundColor, fontSize의 타입을 theme 객체에서 추출하고 해당 타입을 Button 컴포넌트에 사용했다.

const colors = {
  black: '#000000',
  gray: '#222222',
  white: '#FFFFFF',
  mint: '#2AC1BC',
}

const theme = {
  colors: {
    default: colors.gray,
    ...colors
  },
  backgroundColor: {
    default: colors.white,
    gray: colors.gray,
    mint: colors.mint,
    black: colors.black,
  },
  fontSize: {
    default: '16px',
    small: '14px',
    large: '18px',
  },
}

type ColorType = keyof typeof theme.colors
/**
type ColorType = "default" | "gray" | "mint" | "black" | "white"
*/

type BackgroundColorType = keyof typeof theme.backgroundColor
/**
type BackgroundColorType = "default" | "gray" | "mint" | "black"
*/

type FontSizeType = keyof typeof theme.fontSize
/**
type FontSizeType = "default" | "small" | "large"
*/

이처럼 theme뿐만 아니라 여러 상숫값을 인자나 props로 받은 다음에 객체의 키값을 추출한 타입을 활용하면 객체에 접근할 때 타입스크립트의 도움을 받아 실수를 방지할 수 있다.