유틸리티 타입이란?

TypeScript가 제공하는 타입 변환 도구입니다.

Partial과 Required의 차이는?

Partial은 모든 프로퍼티를 선택적으로, Required는 필수로 만듭니다.

Pick과 Omit의 차이는?

Pick은 특정 프로퍼티를 선택하고, Omit은 제외합니다.

TypeScript 유틸리티 타입 | Partial, Pick, Omit, Record

2025년 5월 7일 · 22분 읽기 · 수정 2026년 3월 29일 중급 튜토리얼

이 글의 핵심

유틸리티 타입은 이미 정의한 타입에서 일부만 골라 내거나, 모두 선택적으로 바꾸는 등 변환을 한 번에 해 주는 도구입니다. 같은 명판을 여러 형태로 찍어 쓰는 느낌에 가깝습니다.

들어가며

유틸리티 타입은 이미 정의한 타입에서 일부만 골라 내거나, 모두 선택적으로 바꾸는 등 변환을 한 번에 해 주는 도구입니다. 같은 명판을 여러 형태로 찍어 쓰는 느낌에 가깝습니다.

JavaScript에서 TypeScript로의 전환

“런타임 에러는 프로덕션에서 터진다”는 말이 있습니다. JavaScript로 개발하던 시절, 이 말을 뼈저리게 체감했습니다. 테스트는 다 통과했는데 배포 후 사용자가 이상한 데이터를 입력하면 앱이 터지는 거습니다. 특히 팀 프로젝트에서 다른 사람이 작성한 함수의 반환 타입을 잘못 이해해서 버그가 발생하는 일이 잦았습니다. TypeScript를 도입한 후 가장 먼저 느낀 건 안심이었습니다. IDE가 자동완성을 정확히 해주으며, 타입이 맞지 않으면 빨간 줄로 미리 알려줍니다. 리팩토링할 때도 “이 함수를 바꾸면 어디가 깨질까?” 걱정할 필요가 없어졌습니다. 물론 처음엔 타입 정의 작성이 번거로웠지만, 몇 달 후 그 타입 정의 덕분에 버그를 미리 잡는 경험을 하고 나니 돌아갈 수 없었습니다.

1. Partial

개념

모든 프로퍼티를 선택적(optional)으로 만듭니다.

interface User {
    id: string;
    name: string;
    email: string;
    age: number;
}
type PartialUser = Partial<User>;
// {
//     id?: string;
//     name?: string;
//     email?: string;
//     age?: number;
// }

실전 예제

function updateUser(id: string, updates: Partial<User>): User {
    const user = getUser(id);
    return { ...user, ...updates };
}
updateUser("U001", { name: "김철수" });
updateUser("U002", { email: "new@test.com", age: 30 });

구현 원리

type MyPartial<T> = {
    [K in keyof T]?: T[K];
};

2. Required

개념

모든 프로퍼티를 필수(required)로 만듭니다.

interface User {
    id: string;
    name: string;
    email?: string;
    age?: number;
}
type RequiredUser = Required<User>;
// {
//     id: string;
//     name: string;
//     email: string;
//     age: number;
// }

구현 원리

type MyRequired<T> = {
    [K in keyof T]-?: T[K];
};

3. Readonly

개념

모든 프로퍼티를 읽기 전용으로 만듭니다.

interface User {
    id: string;
    name: string;
    email: string;
}
type ReadonlyUser = Readonly<User>;
const user: ReadonlyUser = {
    id: "U001",
    name: "홍길동",
    email: "hong@test.com"
};
// user.name = "김철수";  // ❌ 에러

구현 원리

type MyReadonly<T> = {
    readonly [K in keyof T]: T[K];
};

4. Pick<T, K>

개념

특정 프로퍼티만 선택합니다.

interface User {
    id: string;
    name: string;
    email: string;
    age: number;
    address: string;
}
type UserPreview = Pick<User, "id" | "name">;
// {
//     id: string;
//     name: string;
// }
const preview: UserPreview = {
    id: "U001",
    name: "홍길동"
};

실전 예제

type LoginForm = Pick<User, "email">;
type SignupForm = Pick<User, "name" | "email" | "age">;

구현 원리

type MyPick<T, K extends keyof T> = {
    [P in K]: T[P];
};

5. Omit<T, K>

개념

특정 프로퍼티를 제외합니다.

interface User {
    id: string;
    name: string;
    email: string;
    password: string;
}
type UserWithoutPassword = Omit<User, "password">;
// {
//     id: string;
//     name: string;
//     email: string;
// }
const user: UserWithoutPassword = {
    id: "U001",
    name: "홍길동",
    email: "hong@test.com"
};

실전 예제

type UserResponse = Omit<User, "password">;
type CreateUserRequest = Omit<User, "id">;

구현 원리

type MyOmit<T, K extends keyof T> = Pick<T, Exclude<keyof T, K>>;

6. Record<K, T>

개념

키와 값의 타입을 지정하여 객체 타입을 만듭니다.

type Role = "admin" | "user" | "guest";
type Permissions = Record<Role, string[]>;
const permissions: Permissions = {
    admin: ["read", "write", "delete"],
    user: ["read", "write"],
    guest: [read]
};

실전 예제

type ErrorCode = "NOT_FOUND" | "UNAUTHORIZED" | "SERVER_ERROR";
type ErrorMessages = Record<ErrorCode, string>;
const errors: ErrorMessages = {
    NOT_FOUND: "리소스를 찾을 수 없습니다",
    UNAUTHORIZED: "인증이 필요합니다",
    SERVER_ERROR: "서버 에러가 발생했습니다"
};
type Language = "ko" | "en" | "ja";
type Translations = Record<Language, Record<string, string>>;
const translations: Translations = {
    ko: { greeting: "안녕하세요", goodbye: "안녕히 가세요" },
    en: { greeting: "Hello", goodbye: "Goodbye" },
    ja: { greeting: "こんにちは", goodbye: "さようなら" }
};

구현 원리

type MyRecord<K extends keyof any, T> = {
    [P in K]: T;
};

7. Exclude<T, U>

개념

Union 타입에서 특정 타입을 제외합니다.

type AllRoles = "admin" | "user" | "guest" | "moderator";
type NonAdminRoles = Exclude<AllRoles, "admin">;
// "user" | "guest" | "moderator"
let role: NonAdminRoles = "user";

8. Extract<T, U>

개념

Union 타입에서 특정 타입만 추출합니다.

type AllRoles = "admin" | "user" | "guest" | "moderator";
type AdminRoles = Extract<AllRoles, "admin" | "moderator">;
// "admin" | "moderator"
let role: AdminRoles = "admin";

9. NonNullable

개념

null과 undefined를 제거합니다.

type MaybeString = string | null | undefined;
type DefiniteString = NonNullable<MaybeString>;
// string
let value: DefiniteString = "hello";

10. ReturnType

개념

함수의 반환 타입을 추출합니다.

function getUser() {
    return {
        id: "U001",
        name: "홍길동",
        email: "hong@test.com"
    };
}
type User = ReturnType<typeof getUser>;

11. Parameters

개념

함수의 매개변수 타입을 튜플로 추출합니다.

function createUser(name: string, age: number, email: string) {
    return { name, age, email };
}
type CreateUserParams = Parameters<typeof createUser>;
// [string, number, string]
const params: CreateUserParams = ["홍길동", 25, "hong@test.com"];
createUser(...params);

12. 실전 예제

예제 1: API 타입 관리

interface User {
    id: string;
    name: string;
    email: string;
    password: string;
    createdAt: Date;
    updatedAt: Date;
}
type CreateUserRequest = Omit<User, "id" | "createdAt" | "updatedAt">;
type UpdateUserRequest = Partial<Omit<User, "id" | "createdAt" | "updatedAt">>;
type UserResponse = Omit<User, "password">;
type UserListItem = Pick<User, "id" | "name" | "email">;

예제 2: 폼 상태 관리

interface FormField<T> {
    value: T;
    error: string | null;
    touched: boolean;
}
type FormState<T> = {
    [K in keyof T]: FormField<T[K]>;
};
interface LoginData {
    email: string;
    password: string;
}
type LoginFormState = FormState<LoginData>;
const form: LoginFormState = {
    email: { value: "", error: null, touched: false },
    password: { value: "", error: null, touched: false }
};

예제 3: 상태 관리

interface AppState {
    user: User | null;
    posts: Post[];
    loading: boolean;
    error: string | null;
}
type LoadingState = Pick<AppState, "loading">;
type ErrorState = Pick<AppState, "error">;
type DataState = Omit<AppState, "loading" | "error">;

정리

핵심 요약

Partial: 모든 프로퍼티 선택적
Required: 모든 프로퍼티 필수
Readonly: 모든 프로퍼티 읽기 전용
Pick: 특정 프로퍼티 선택
Omit: 특정 프로퍼티 제외
Record: 키-값 객체 타입
Exclude/Extract: Union 타입 필터링
ReturnType: 함수 반환 타입
Parameters: 함수 매개변수 타입

유틸리티 타입 비교

타입	용도	예시
Partial	선택적 변환	업데이트
Required	필수 변환	완전한 데이터
Pick	선택	일부 필드
Omit	제외	비밀번호 제외
Record	객체 생성	권한, 에러 메시지

다음 단계

자주 묻는 질문 (FAQ)

Q. 이 내용을 실무에서 언제 쓰나요?

A. TypeScript 유틸리티 타입에 대해 정리한 개발 블로그 글입니다. interface User { id: string; name: string; email: string; age: number; }. Start … 실무에서는 위 본문의 예제와 선택 가이드를 참고해 적용하면 됩니다.

Q. 선행으로 읽으면 좋은 글은?

A. 각 글 하단의 이전 글 또는 관련 글 링크를 따라가면 순서대로 배울 수 있습니다. C++ 시리즈 목차에서 전체 흐름을 확인할 수 있습니다.

Q. 더 깊이 공부하려면?

A. cppreference와 해당 라이브러리 공식 문서를 참고하세요. 글 말미의 참고 자료 링크도 활용하면 좋습니다.

같이 보면 좋은 글 (내부 링크)

이 주제와 연결되는 다른 글입니다.

이 글에서 다루는 키워드 (관련 검색어)

TypeScript, 유틸리티타입, Partial, Pick, Omit, Record 등으로 검색하시면 이 글이 도움이 됩니다.

이 글이 도움이 되셨나요?

여러분의 피드백은 더 나은 콘텐츠를 만드는 데 도움이 됩니다

문제가 있거나 개선 제안이 있으시면 연락처로 알려주세요.