카카오엔터 개발자, TypeScript 실무 팁 4가지 공유

카카오엔터테인먼트 개발자가 TypeScript 사용 시 타입 에러를 줄이고 생산성을 높이는 4가지 실무 팁을 공유했다. 저자는 any 타입 사용을 지양하고 정적 타입의 장점을 극대화하는 방법을 제시한다.

enum 대신 union type

enum은 컴파일 시 객체를 생성해 런타임에 영향을 주므로, 타입 정보만 사용하는 union type을 권장한다. const enum은 런타임 영향을 없앨 수 있지만, import 없이 문자열 리터럴로 바로 사용할 수 있는 union type이 개발 생산성 측면에서 더 유리하다.

index signature 대신 mapped type

객체 키의 타입을 제한할 때 index signature보다 mapped type을 사용하는 것이 안전하다. mapped type은 정의된 타입에 속하지 않는 키를 허용하지 않으므로, 타입에 새로운 항목이 추가될 때 누락된 데이터를 컴파일 에러로 방지할 수 있다.

외부 패키지 타입 치환

react-redux의 useSelector 등에서 타입 추론이 실패할 경우, 매번 타입을 명시하거나 커스텀 훅을 만드는 대신 declare module을 통해 기본 타입(DefaultRootState)을 직접 치환하는 방법을 추천한다. 이를 통해 반복적인 타입 명시 없이 깔끔한 코드를 유지할 수 있다.

타입 가드 활용

typeof, in 키워드 및 공통 속성(discriminated union)을 활용해 타입 범위를 좁히는 type guard를 적극 활용해야 한다. TypeScript 3.7부터는 asserts 키워드를 이용해 조건부 타입 단정을 수행할 수 있어 가독성과 안정성을 동시에 확보할 수 있다.