GM 오락실
← 개인 공부 · Frontend
STUDY NOTE · 개념 정리

TypeScript 타입 정리: 유니온과 내로잉, 제네릭, 유틸리티 타입, any vs unknown

Frontend
TypeScript는 자바스크립트에 정적 타입을 더해 실행 전에 오류를 잡는다. 타입은 이름이 아니라 구조(모양)로 호환성을 판단한다. 여러 가능성은 유니온으로 표현하고 조건문으로 좁히며(내로잉), 재사용은 제네릭과 유틸리티 타입으로 한다. 모르는 값은 any가 아니라 unknown으로 받는다.

1. 구조적 타이핑

interface Point { x: number; y: number; }

function print(p: Point) { console.log(p.x, p.y); }

const pos = { x: 1, y: 2, z: 3 };
print(pos); // OK — 필요한 속성을 다 갖고 있으면 호환
print({ x: 1, y: 2, z: 3 }); // 에러 — 객체 리터럴을 바로 넘기면 초과 속성 검사

자바처럼 implements를 선언하지 않아도 모양이 맞으면 같은 타입으로 본다. 단, 객체 리터럴을 바로 넘길 때는 오타를 잡기 위해 초과 속성 검사를 한다.

2. type vs interface

구분interfacetype
객체 모양 정의가능가능
확장extends& (교차 타입)
같은 이름으로 다시 선언자동 병합 (선언 병합)에러
유니온, 튜플, 원시 타입 별칭불가가능
매핑 타입·조건부 타입불가가능
주 용도객체·클래스 계약, 라이브러리 타입 확장유니온, 조합, 유틸리티 결과

3. 유니온, 교차, 리터럴 타입

type Status = "READY" | "PAID" | "SHIPPED"; // 리터럴 유니온
type Id = number | string; // 유니온: 둘 중 하나
type Timestamped = { createdAt: Date };
type Order = { id: Id; status: Status } & Timestamped; // 교차: 둘 다 만족

const ROLES = ["ADMIN", "USER"] as const; // readonly ["ADMIN", "USER"]
type Role = (typeof ROLES)[number]; // "ADMIN" | "USER"

문자열 상수 목록은 enum 대신 리터럴 유니온이나 as const 배열로 만드는 경우가 많다. 런타임 코드가 생기지 않고, 배열에서 타입을 뽑아 쓸 수 있다.

4. 타입 좁히기 (Narrowing)

방법예좁혀지는 것
typeoftypeof v === "string"원시 타입
instanceofe instanceof Error클래스 인스턴스
in"email" in user특정 속성을 가진 타입
동등 비교v === null, v !== undefinednull·undefined 제거
판별 유니온result.type === "ok"공통 리터럴 필드로 구분된 유니온 멤버
사용자 정의 타입 가드function isUser(v): v is User함수 판단 결과대로
type Result =
| { type: "ok"; data: string[] }
| { type: "error"; message: string };

function handle(r: Result) {
switch (r.type) {
case "ok":
return r.data.length; // 여기서 r은 ok 타입
case "error":
return r.message; // 여기서 r은 error 타입
default: {
const never: never = r; // 멤버가 추가됐는데 처리 안 하면 컴파일 에러
return never;
}
}
}

5. 제네릭

제네릭은 타입을 매개변수로 받아, 입력과 출력의 타입 관계를 유지하면서 여러 타입에 재사용하게 해 준다.

function first<T>(arr: T[]): T | undefined {
return arr[0];
}
first([1, 2]); // number | undefined
first(["a"]); // string | undefined

// 제약 조건: K는 T의 키 중 하나여야 한다
function pick<T, K extends keyof T>(obj: T, key: K): T[K] {
return obj[key];
}
pick({ id: 1, name: "kim" }, "name"); // string
pick({ id: 1, name: "kim" }, "age"); // 에러: "age"는 키가 아님

interface ApiResponse<T> {
success: boolean;
data: T;
}

6. 유틸리티 타입

유틸리티의미예
Partial<T>모든 속성을 선택적으로수정 폼의 일부 필드만 보낼 때
Readonly<T>모든 속성을 읽기 전용으로바꾸면 안 되는 상태
Pick<T, K>일부 속성만 고름Pick<User, "id" | "name">
Omit<T, K>일부 속성을 뺌Omit<User, "password">
Record<K, V>키 K, 값 V인 객체Record<Status, string> (상태별 라벨)
Exclude<U, M>유니온 U에서 M에 해당하는 멤버 제거Exclude<Status, "READY">
ReturnType<F>함수의 반환 타입ReturnType<typeof useCart>
Awaited<T>Promise를 벗긴 타입Awaited<ReturnType<typeof getUser>>

7. any vs unknown vs never

타입무엇을 담을 수 있나그대로 사용할 수 있나용도
any아무 값가능 (타입 검사를 끔)마이그레이션 중 임시. 가능하면 쓰지 않음
unknown아무 값불가 (좁힌 뒤에만 사용)외부 입력, JSON.parse 결과, catch의 에러
never어떤 값도 없음-도달 불가능한 분기, 항상 throw하는 함수의 반환, 완전성 검사
function parse(json: string) {
const value: unknown = JSON.parse(json);
value.name; // 에러: unknown은 바로 못 씀
if (typeof value === "object" && value !== null && "name" in value) {
return value.name; // 좁힌 뒤에는 사용 가능
}
}

any는 한 번 들어오면 그 값과 닿는 코드 전체로 타입 검사 해제가 퍼진다. unknown은 "아직 모른다"를 정직하게 표현하고, 쓰기 전에 확인을 강제한다.

8. 실제로 어떻게 적용되나

  1. API 응답 타입: 서버 DTO와 같은 모양의 타입을 정의하고 ApiResponse<T> 같은 제네릭으로 감싼다. 응답 데이터 자체는 런타임에 검증되지 않으므로, 외부 데이터가 중요하면 zod 같은 스키마 검증 라이브러리로 확인한다.
  2. 상태별 UI 분기: 로딩·성공·실패를 boolean 여러 개로 두면 "로딩 중인데 에러도 있음" 같은 불가능한 조합이 생긴다. 판별 유니온으로 만들면 가능한 상태만 표현된다.
  3. catch 블록의 에러: 엄격 모드에서는 catch (e)의 e가 unknown이다. e instanceof Error로 좁힌 뒤 message를 쓴다.

9. 면접 질문으로 정리

  1. Q. type과 interface의 차이는? 둘 다 객체 모양을 정의할 수 있다. interface는 선언 병합과 extends를 지원하고, type은 유니온·튜플·매핑 타입 같은 복잡한 타입 표현이 가능하다.
  2. Q. any와 unknown의 차이는? 둘 다 모든 값을 받을 수 있지만, any는 타입 검사를 끄고 unknown은 타입을 좁히기 전까지 사용을 막는다. 외부 입력에는 unknown이 안전하다.
  3. Q. 제네릭을 쓰는 이유는? 여러 타입에서 재사용하면서도 입력과 출력의 타입 관계를 유지해 타입 안정성을 잃지 않기 위해서다.
  4. Q. 타입 내로잉이란? typeof, instanceof, in, 판별 필드 비교 같은 조건문으로 유니온 타입의 범위를 좁혀 그 분기에서 구체적인 타입으로 다루는 것이다.
  5. Q. never 타입은 언제 쓰나? 도달할 수 없는 코드나 항상 예외를 던지는 함수의 반환 타입에 쓰고, switch 문에서 모든 유니온 멤버를 처리했는지 확인하는 완전성 검사에 쓴다.
Gunmo Lee
since 2021.07
TypeScript 타입 정리: 유니온과 내로잉, 제네릭, 유틸리티 타입, any vs unknown | GM 오락실