Sanyanggae LogoSanyanggae

📱 모바일 & 앱 개발

TypeScript 조건부 타입과 infer: 작은 예제로 확인하는 타입 변환

조건부 타입, 유니온 분배와 템플릿 리터럴을 예제로 살펴보고 런타임 검증과의 차이를 설명합니다.

사냥개 (Sanyanggae)발행 수정 6분
TypeScript 조건부 타입과 infer: 작은 예제로 확인하는 타입 변환: 조건부 타입, infer와 분배, 런타임 검증을 정리한 설명용 도식
사냥개 제작 설명용 도식 · 조건부 타입 · infer와 분배 · 런타임 검증.

TypeScript에서 비슷한 타입 선언이 반복되면 입력 타입에서 결과 타입을 계산하는 방법을 찾게 됩니다. 중요한 것은 짧아진 글자 수보다 타입 사이의 관계가 읽는 사람에게 분명한가입니다. 이 글은 가상의 배송 알림 서비스를 예로 들어 조건부 타입과 infer를 살펴보고, 외부 데이터가 실제로 올바른지 확인하는 작업과 구분합니다.

1. 조건부 타입은 타입을 입력으로 받는 분기다

공식 조건부 타입 문서는 extends 조건에 따라 결과 타입을 고르는 문법을 설명합니다. 아래 예시는 문자열 타입인지에 따라 불리언 리터럴 타입을 만듭니다. 실행 중에 문자열을 검사하는 함수는 아닙니다.

type IsText<T> = T extends string ? true : false;
type NameIsText = IsText<'parcel'>; // true
type CountIsText = IsText<3>;       // false

배송 알림을 만드는 함수가 문자열 식별자를 받고, 내부 처리 함수는 숫자 식별자를 받는다고 가정해 보겠습니다. 조건부 타입을 쓰기 전에 두 식별자를 왜 구분하는지 설명할 수 있어야 합니다. 실제로 다른 의미라면 별도 이름이 도움이 되고, 단순한 표기 차이라면 입력 형식을 통일하는 편이 더 읽기 쉬울 수 있습니다. 타입 기법으로 데이터 설계의 모호함을 가리지는 마세요.

타입을 검토할 때는 기대하는 입력과 결과를 쌍으로 적습니다. 문자열, 숫자, 유니온과 예상 밖의 입력을 작은 예제로 나눠 보면 복잡한 선언을 읽는 부담이 줄어듭니다. 주석으로 쓴 결과와 편집기가 추론한 타입이 일치하는지도 확인합니다. 타입 이름이 자연스러워 보여도 실제 계산 결과는 다를 수 있습니다.

2. 유니온 분배는 배열의 뜻을 바꾼다

타입 매개변수가 그대로 조건의 왼쪽에 놓이면 유니온의 각 구성원에 조건이 적용되는 분배가 일어납니다. 이를 막고 전체 유니온을 하나로 취급하고 싶다면 대괄호로 감싸는 형태를 비교할 수 있습니다.

type SeparateLists<T> = T extends unknown ? T[] : never;
type Together<T> = [T] extends [unknown] ? T[] : never;
type A = SeparateLists<string | number>; // string[] | number[]
type B = Together<string | number>;      // (string | number)[]
const a: A = ['a', 'b'];
const b: B = ['a', 1];

첫 번째는 문자열만 있는 배열 또는 숫자만 있는 배열입니다. 두 번째는 하나의 배열 안에 문자열과 숫자가 함께 들어갈 수 있습니다. 배송 목록 전체가 한 종류의 코드만 담아야 하는지, 항목마다 다른 종류를 허용하는지에 따라 적합한 결과가 달라집니다. 화면에는 모두 대괄호가 보이지만 두 배열의 계약은 같지 않습니다.

실무에서 문제가 생기면 복잡한 유틸리티 타입 전체를 한 번에 읽기보다 입력을 한 구성원씩 넣어 보세요. 문자열을 넣은 결과, 숫자를 넣은 결과와 두 타입의 유니온을 넣은 결과를 비교합니다. 분배를 의도한 것인지가 드러나면 대괄호를 추가할 이유도 설명할 수 있습니다. 타입 검토 기록에는 최종 결과만 쓰지 말고 허용하고 싶은 값의 예도 남기는 편이 좋습니다.

3. infer는 구조 안의 타입을 이름 붙여 꺼낸다

infer는 조건부 타입에서 맞춰 본 구조의 일부에 이름을 붙이는 데 사용합니다. 다음 예시는 Promise 한 단계를 벗기는 작은 타입입니다.

type OneResult<T> = T extends Promise<infer Value> ? Value : T;
type Parcel = OneResult<Promise<{ tracking: string }>>;
type ParcelList = OneResult<Promise<string[]>>;

이 코드는 비동기 작업을 실행하거나 기다리지 않습니다. 결과의 형태를 컴파일 단계에서 표현할 뿐입니다. 함수 이름을 Resolved처럼 지으면 실제 값이 이미 도착했다는 인상을 줄 수도 있으므로, 이 타입을 어느 위치에 쓰는지 문맥을 함께 봅니다. 실행 중 대기는 여전히 비동기 코드에서 처리해야 합니다.

재귀적으로 기다린 결과 타입이 필요하다면 직접 만든 한 단계 예시를 계속 확장하기 전에 표준 유틸리티 타입 Awaited를 확인하세요. 교육용 타입의 단순함과 공용 도구의 요구사항은 다릅니다. 팀에서 새 유틸리티를 도입한다면 표준 타입과 결과가 다른 입력, 그 차이가 필요한 이유를 문서화하는 것이 좋습니다.

4. 템플릿 리터럴로 이벤트 이름을 연결하기

템플릿 리터럴 타입은 문자열 리터럴의 조합을 타입으로 나타낼 수 있습니다. 배송 서비스에서는 영역과 동작을 조합한 이벤트 이름을 예로 들 수 있습니다.

type Scope = 'parcel' | 'address';
type Action = 'created' | 'updated';
type EventName = `${Scope}:${Action}`;
const event: EventName = 'parcel:created';

오타가 있는 이름을 컴파일 단계에서 발견할 수 있지만, 조합 가능한 모든 이벤트가 실제 서비스에서 유효한지는 다른 문제입니다. 예를 들어 주소 삭제 이벤트만 지원한다면 단순한 영역·동작의 곱으로는 규칙이 정확히 표현되지 않을 수 있습니다. 이때는 허용하는 이벤트와 payload를 명시적으로 대응시키는 설계를 먼저 생각해 보세요.

이벤트가 많아질수록 독자가 실제 이름을 쉽게 찾을 수 있는지도 중요합니다. 자동 조합 규칙을 여러 단계 이어 붙이는 대신, 외부 시스템에 전달하는 이름은 한 파일에서 확인할 수 있게 만드는 방법도 있습니다. 추상화를 넣기 전과 후에 새로운 팀원이 잘못된 이벤트를 어떻게 발견할지 비교해 보세요. 타입의 정교함과 사용성은 함께 평가해야 합니다.

5. 외부 JSON은 실행 중에 검사해야 한다

API 응답에 User나 Parcel이라는 타입을 붙이는 것만으로 실제 응답이 그 구조인지 보장되지는 않습니다. 외부 값을 unknown으로 받은 뒤 필요한 필드를 검사하는 간단한 형태를 살펴봅시다.

function hasTracking(value: unknown): value is { tracking: string } {
  return typeof value === 'object' && value !== null
    && 'tracking' in value && typeof value.tracking === 'string';
}
const incoming: unknown = { tracking: 'DEMO-001' };
if (hasTracking(incoming)) console.log(incoming.tracking);

이 검사는 tracking 필드가 문자열인지까지만 확인합니다. 송장 번호가 실제 존재하는지, 사용자가 그 배송을 볼 권한이 있는지까지 확인하지는 않습니다. 타입 좁히기, 업무 규칙과 권한 검사를 서로 다른 책임으로 생각해야 합니다. 공식 Narrowing 문서는 조건문을 통해 타입 정보가 좁혀지는 과정을 설명합니다.

6. 타입 도구를 선택하는 작은 검토 순서

먼저 허용할 실제 값 두 개와 거절할 값 두 개를 적어 보세요. 그다음 일반적인 유니온과 명시적 객체 선언으로 뜻을 표현해 봅니다. 반복되는 관계가 남을 때 조건부 타입이나 infer를 사용하면 기법을 넣는 이유가 분명해집니다. 선언을 읽는 시간이 크게 늘어났다면 공통 부분만 추출하고 나머지는 평범한 타입으로 남기는 선택도 가능합니다.

마지막으로 타입 검사와 런타임 검사를 따로 실행합니다. 잘못된 이벤트 이름을 컴파일러가 거절하는지 확인하는 작업과, 서버에서 누락된 필드를 보내도 프로그램이 오류를 설명하는지 확인하는 작업은 서로 보완합니다. 작은 예제의 결과를 확인한 뒤 실제 입력 경계까지 연결해야 타입 변환이 안전한 애플리케이션 설계에 도움이 됩니다.

근거와 참고 자료

이 글은 공개된 자료를 바탕으로 설명합니다. 출처 표시는 해당 기관의 감수나 인증을 의미하지 않습니다.

운영자 소개 및 연락처

같은 주제의 다른 글