유니언과 교차 형식의 실전 패턴

시작하기

선택적 페이로드 패턴

type Event =
  | { type: 'click'; x: number; y: number }
  | { type: 'keypress'; key: string }
  | { type: 'blur' };

교차 타입을 사용한 빌더/믹스인

type Serializable = { serialize(): string };
type Validatable = { validate(): boolean };
type Model = Serializable & Validatable & { id: number };

입력 정규화를 위한 유니언

function toArray<T>(val: T | T[]): T[] {
  return Array.isArray(val) ? val : [val];
}

교차 타입을 사용한 브랜드 타입

type UserId = number & { __brand: 'UserId' };
type PostId = number & { __brand: 'PostId' };
// Prevents accidentally mixing IDs

WithOptional 패턴

type RequiredFields = { id: number; email: string };
type OptionalFields = Partial<{ name: string; bio: string }>;
type UserUpdate = RequiredFields & OptionalFields;

다형성 컴포넌트 속성

type ButtonProps =
  | { variant: 'primary'; onClick: () => void }
  | { variant: 'link'; href: string };

서드 파티 타입 확장

import type { Request } from 'express';
type AuthRequest = Request & { user: User };

유니언과 교차 타입 결합하기

type Admin = { role: 'admin' };
type User = { role: 'user' };
type LoggedIn = { sessionId: string };
type AuthUser = (Admin | User) & LoggedIn;

유니언 멤버를 위한 타입 가드

function isAdmin(u: AuthUser): u is Admin & LoggedIn {
  return u.role === 'admin';
}

교차 타입의 분배 동작

type Base = { id: number };
type AB = Base & (string | number);
// equivalent to: (Base & string) | (Base & number)

빠른 확인

복습