Go to list

타입스크립트 프로그래밍

보리스 체르니

2025.07.01

입문자가 읽기에 좋은 책이란 생각이 들었다. 반면 이펙티브 타입스크립트는 숙련자가 볼 때 도움 되는 팁 같은 느낌이었다.



컴패니언 객체 패턴

  • 같은 이름을 공유하는 객체와 클래스를 쌍으로 연결한다.
  • 타입스크립트에서 타입과 값은 별도의 네임스페이스를 갖는다.
  • 캠패니언 객체 패턴을 이용하면 별도의 네임스페이스를 이용해 한 번은 타입으로, 한 번은 값으로 두 번 이름을 선언할 수 있다.
type Currency = {
  unit: 'EUR' | 'GBP' | 'JPY' | 'USD'
  value: number
}

let Currency = {
  DEFAULT: 'USD',
  from(value: number, unit = Currency.DEFAULT): Currency {
    return { unit, value }
  }
}
  • 이 패턴을 이용하면 타입과 값 정보를 Currency 같은 한 개의 이름으로 그룹화할 수 있다.
  • 호출자는 이 둘을 한 번에 임포트할 수 있다.
  • 타입과 객체가 의미상 관련되어 있고, 이 객체가 타입을 활용하는 유틸리티 메서드를 제공한다면 컴패니언 객체 패턴을 이용하자.

리터럴 타입을 이용해 유니온 타입이 만들어낼 수 있는 각각의 경우를 태그하는 방식으로 유니온의 멤버가 서로 중복되는 문제를 해결할 수 있다.

// as-is
type UserTextEvent = { value: string, target: HTMLInputElement }
type UserMouseEvent = { value: [number, number], target: HTMLElement }

type UserEvent = UserTextEvent | UserMouseEvent

function handle(event: UserEvent) {
  if (typeof event.value === string) {
    event.value // string
    event.target // HTMLInputElement | HTMLElement (!!!)
    // ...
    return
  }
  event.value // [number, number]
  event.target // HTMLInputElement | HTMLElement (!!!)
}
  • event.value는 잘 정제되었지만 event.target에는 적용되지 않았다.
  • handle이 UserEvent 타입의 매개변수를 받는다는 것은 UserTextEvent나 UserMouseEvent만 전달할 수 있다는 의미가 아니다. 사실 UserMouseEvent | UserTextEvent 타입의 인수를 전달할 수도 있기 때문이다.
  • 이때 태그해서 해결해볼 수 있다. 보통 태그된 유니온은 객체 타입을 사용한다. 보통 태그로 문자열 리터럴 타입을 사용한다. 태그는 유니온 타입 내에서 고유해야 한다.
// to-be
type UserTextEvent = {
  type: 'TextEvent',
  value: string,
  target: HTMLInputElement
}
type UserMouseEvent = {
  type: 'MouseEvent',
  value: [number, number],
  target: HTMLElement
}

type UserEvent = UserTextEvent | UserMouseEvent

function handle(event: UserEvent) {
  if (event.type === 'TextEvent') {
    event.value // string
    event.target // HTMLInputElement (ok)
    // ...
    return
  }
  event.value // [number, number]
  event.target // HTMLElement (ok)
}
  • event를 태그된 필드(event.type) 값에 따라 정제하도록 수정했다.
  • 유니온 타입의 다양한 경우를 처리하는 함수를 구현해야 한다면 태그된 유니온을 사용하자.

타입 정제는 강력하지만 현재 영역(유효범위)에 속한 변수만을 처리할 수 있다는 점이 문제다.

  • 한 영역에서 다른 영역으로 이동하면 기존의 정제 결과물은 사라져버린다.
  • 결국 타입스크립트가 알고 있는 사실은 isString이 boolean을 반환한다는 것뿐이다.
  • 따라서 타입 검사기에 isString이 boolean을 반환할 뿐 아니라 boolean이 true면 isString에 전달한 인수가 string임을 알려야 한다.

매개변수 타입을 정제하고 boolean을 반환하는 함수가 있다면 사용자 정의 타입 안전 장치를 이용해 함수가 제대로 동작함을 보장하도록 만들 수 있다.

  • 사용자 정의 타입 안전 장치를 사용하지 않으면 isString 같은 잘 캡슐화되고 가독성 좋은 함수를 활용하지 못하고, 대신 typeof나 instanceof 타입 안전 장치를 코드에 일일이 추가해야 한다.
function isString(a: unknown): a is string {
  return typeof a === 'string'
}
  • 타입 안전 장치는 타입스크립트의 내장 기능으로 typeof와 instanceof로 타입을 정제할 수 있게 해준다.
  • 하지만 때로는 자신만의 타입 안전 장치가 필요한데 이때는 is 연산자를 사용한다.

조건부 타입을 사용하면 타입스크립트는 유니온 타입을 조건부의 절들로 분배한다.

type ToArray<T> = T[]
type A = ToArray<number> // number[]
type B = ToArray<number | string> // (number | string)[]

// 조건부 타입을 사용하면 타입스크립트는 유니온 타입을 조건부의 절들로 분배한다.
type ToArray2<T> = T extends unknown ? T[] : T[]
type A = ToArray2<number> // number[]
type B = ToArray2<number | string> // number[] | string[]
  • 이를 이용하면 다양한 공통 연산을 안전하게 표현할 수 있다.

infer 키워드를 사용해 조건부 타입에서 제네릭 타입을 인라인으로 선언할 수 있다.

type ElementType<T> = T extends unknown[] ? T[number] : T
type A = ElementType<number[]> // number

// infer를 이용하면 이 코드를 다음처럼 다시 구현할 수 있다.
type ElementType2<T> = T extends (infer U)[] ? U : T
type B = ElementType2<number[]> // number
  • ElementType2에 어떤 T를 전달했느냐를 보고 U의 타입을 추론한다.

nonnull 어서션 연산자(!)를 제거하려면 유니온 타입으로 분리하면 된다.

// as-is
type Dialog = {
  id?: string
}

function closeDialog(dialog: Dialog) {
  if (!dialog.id) {
    return
  }
  setTimeout(() =>
    removeFromDOM(
      dialog,
      document.getElementById(dialog.id!)!
  )
}

function removeFromDOM(dialog: Dialog, element: Element) {
  element.parentNode!.removeChild(element)
  delete dialog.id
}

Dialog를 두 타입의 유니온으로 분리해 어서션을 제거할 수 있다.

// to-be
type VisibleDialog = {id: string}
type DestroyedDialog = {}
type Dialog = VisibleDialog | DestroyedDialog

// 그리고 이 유니온을 이용하도록 closeDialog 코드를 수정한다.
function closeDialog(dialog: Dialog) {
  if (!('id' in dialog)) { // 객체의 key에 'id'란 게 있는지
    return
  }
  setTimeout(() =>
    removeFromDOM(
      dialog,
      document.getElementById(dialog.id)! // 어서션 필요 없어짐. dialog.id! -> dialog.id
  )
}

function removeFromDOM(dialog: VisibleDialog, element: Element) { // Dialog -> VisibleDialog 타입 교체
  element.parentNode!.removeChild(element)
  delete dialog.id
}
  • 화살표 함수 내부에서도 타입스크립트는 dialog의 참조가 바뀌지 않았음을 안다.
  • 즉, 화살표 함수 내부의 dialog는 외부의 dialog와 같은 값이므로, as-is에서 정제를 무효화했던 것과 달리 이번에는 정제 결과가 계속 이어진다.

Comments