06 고급 타입

6.7 이름 기반 타입 흉내내기

타입스크립트의 타입 시스템은 구조에 기반하지만, 이름 기반 타입도 때로는 아주 유용하다.

// as-is
type CompanyID = string
type OrderID = string
type UserID = string
type ID = CompanyID | OrderID | UserID

function queryForUser(id: UserID) {
  // ...
}

let id: CompanyID = 'b4843361'
queryForUser(id) // OK (!!!)
  • UserID는 string의 별칭일 뿐이므로 이 정의로는 버그를 확실하게 방지할 수 없다.
  • 이 상황이 바로 이름 기반 타입이 유용한 사례다.

타입스크립트는 이름 기반 타입을 제공하지 않지만 **타입 브랜딩(type branding)**이라는 기법으로 이를 흉내낼 수 있다.

// to-be
type CompanyID = string & { readonly brand: unique symbol }
type OrderID = string & { readonly brand: unique symbol }
type UserID = string & { readonly brand: unique symbol }
type ID = CompanyID | OrderID | UserID
  • string과 { readonly brand: unique symbol }의 인터섹션은 물론 큰 의미가 없다.
  • 이를 사용한 이유는 이런 타입을 만드는 자연스러운 방법이 존재하지 않으며 이 타입의 값을 만들려면 반드시 어서션을 이용해야 하기 때문이다.
  • 이는 브랜디드 타입의 핵심적인 특징으로, 실수로 잘못된 타입을 사용하기가 아주 어렵게 해준다.
function CompanyID(id: string) {
  return id as CompanyID
}

function OrderID(id: string) {
  return id as OrderID
}

function UserID(id: string) {
  return id as UserID
}
  • 주어진 값(id)을 앞서 정의한 난해한 타입들로 지정하는 데 타입 어서션(as)을 이용한다.
  • 이들 타입을 다음처럼 사용할 수 있다.
function queryForUser(id: UserID) {
  // ...
}

let companyId = CompanyID('dkjdsflk')
let orderId = OrderID('324esdf')
let userId = UserID('dsf4352')

queryForUser(userId) // OK
queryForUser(companyId) // 에러 TS2345: 'Company ID' 타입의 인수를 'UserID' 타입의 매개변수에 할당할 수 없음
  • 런타임에 모든 ID는 단순한 string이다. 즉, 브랜드는 순전히 컴파일 타임에만 쓰이는 구조물이다.
  • 규모가 큰 응용 프로그램, 또는 다양한 종류의 ID를 사용해 타입이 헷갈리는 작업환경이라면 브랜디드 타입으로 안전성을 확보할 수 있다.