DeepPartial 및 DeepReadonly
Partial과 Readonly의 재귀 버전을 만듭니다.
DeepPartial 및 DeepReadonly은(는) CoddyKit의 무료 TypeScript Academy 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 TypeScript Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. TypeScript Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
깊은 유틸리티 타입이 필요한 이유
기본 제공되는 Partial과 Readonly는 한 수준에만 적용됩니다. 중첩된 객체에는 재귀 버전이 필요합니다.
interface Config {
db: { host: string; port: number };
app: { name: string };
}
type Shallow = Partial<Config>;
// Shallow.db is still required — only top level is optionalDeepPartial 구현하기
객체 속성을 재귀적으로 순회하면서 각각을 선택 사항으로 만들고, 속성 값이 객체라면 DeepPartial을 재귀적으로 적용합니다.
type DeepPartial<T> = T extends object
? { [K in keyof T]?: DeepPartial<T[K]> }
: T;DeepPartial 실제 사용
중첩된 구성 타입에 DeepPartial을 적용하여 모든 수준이 선택 사항이 되는 것을 확인합니다.
type PartialConfig = DeepPartial<Config>;
// PartialConfig.db?: { host?: string; port?: number }
const c: PartialConfig = { db: { host: "localhost" } };
// No error — all other fields are optionalDeepReadonly 구현하기
중첩된 객체 타입 안으로 재귀적으로 들어가 모든 깊이의 모든 속성을 readonly로 만듭니다.
type DeepReadonly<T> = T extends object
? { readonly [K in keyof T]: DeepReadonly<T[K]> }
: T;DeepReadonly 실제 사용
깊이 고정된 구성은 어떤 수준에서도 변경할 수 없습니다.
type ReadonlyConfig = DeepReadonly<Config>;
const cfg: ReadonlyConfig = { db: { host: "localhost", port: 5432 }, app: { name: "my-app" } };
// cfg.db.port = 3000; // Error: readonly깊은 타입에서 배열 처리하기
배열은 특별히 처리해야 합니다. 배열을 일반 객체로 취급하지 말고 요소 타입을 재귀적으로 매핑하십시오.
type DeepPartial<T> =
T extends (infer U)[]
? DeepPartial<U>[]
: T extends object
? { [K in keyof T]?: DeepPartial<T[K]> }
: T;원시 타입 처리하기
재귀의 기본 사례에서는 원시 타입을 객체 매핑 타입으로 감싸지 말고 그대로 반환해야 합니다.
type DeepReadonly<T> =
T extends string | number | boolean | null | undefined ? T
: T extends (infer U)[] ? ReadonlyArray<DeepReadonly<U>>
: { readonly [K in keyof T]: DeepReadonly<T[K]> };DeepPartial과 DeepReadonly 결합하기
두 타입을 결합하여 안전한 구성 패치를 위한, 모든 깊이에서 선택적이고 읽기 전용인 타입을 만들 수 있습니다.
type SafePatch<T> = DeepReadonly<DeepPartial<T>>;성능 고려 사항
매우 큰 객체에 재귀 타입을 적용하면 TypeScript 타입 검사가 느려질 수 있습니다. 성능이 중요한 코드에서는 깊이 제한이나 지연 평가를 고려하십시오.
// For very deep schemas, consider using Zod or io-ts
// which provide runtime + compile-time deep typing실제 사용: React 상태 패치
DeepPartial은 큰 상태 객체에서 변경된 부분만 받는 상태 패치 함수에 적합합니다.
function patch<T>(state: T, changes: DeepPartial<T>): T {
return { ...state, ...changes } as T;
}요약: 깊은 유틸리티 타입
DeepPartial과 DeepReadonly는 중첩된 객체의 모든 수준에 수정자를 적용하는 재귀적 매핑 타입입니다. 배열은 별도로 처리하고 원시 타입에는 기본 사례를 사용하십시오.
빠른 확인
DeepPartial의 올바른 재귀 기본 사례는 무엇입니까?
학습 내용
재귀적 매핑 타입을 사용하여 DeepPartial과 DeepReadonly를 구현했습니다. 배열은 특수 사례로 처리하고 기본 사례에서는 항상 원시 타입을 변경 없이 반환하십시오.
자주 묻는 질문
“DeepPartial 및 DeepReadonly” 강의는 무료인가요?
네 — “DeepPartial 및 DeepReadonly” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 TypeScript Academy 강의 전체를 잠금 해제할 수 있습니다. TypeScript Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“DeepPartial 및 DeepReadonly”에서 뭘 배우나요?
Partial과 Readonly의 재귀 버전을 만듭니다. 브라우저에서 직접 실행하는 실습 코드로 TypeScript Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
TypeScript Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 TypeScript Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.
“DeepPartial 및 DeepReadonly” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 TypeScript Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 TypeScript Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- DeepPartial 및 DeepReadonly
- Flatten 및 UnwrapPromise 유틸리티
- TupleToUnion 및 UnionToIntersection
- 형식 유틸리티 라이브러리 배포하기