TypeScript Academy · 강의

필수 단계 강제하기

필수 필드가 모두 설정될 때까지 build()를 실행하지 못하게 합니다.

필수 단계 강제하기은(는) CoddyKit의 무료 TypeScript Academy 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 TypeScript Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. TypeScript Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

build() 조기 호출 막기

이제 누적된 상태를 사용하여 필수 필드가 설정될 때까지 build() 호출을 금지합니다. 실행 시점 검사가 아니라 타입 시스템이 완전하지 않은 빌드를 차단합니다.

최종 구조 정의하기

먼저 완전한 객체와 필수 키를 선언합니다. 빌더는 상태에 필수 키가 모두 포함된 경우에만 build()를 허용합니다.

interface Config {
  url: string;   // required
  method: string; // required
  timeout?: number; // optional
}
type Required = { url: string; method: string };

조건부 build 시그니처

누적된 상태 S가 필수 키를 확장하는 경우에만 build를 사용할 수 있도록 만듭니다. 조건부 타입은 실제 메서드나 사용할 수 없는 메서드 중 하나를 반환합니다.

class Builder<S> {
  build(this: Builder<Required>): Config {
    return this.d as Config;
  }
  private d: Record<string, unknown> = {};
}

this 매개변수 사용하기

this: Builder<Required> 매개변수는 build를 호출할 수 있는 빌더 인스턴스를 제한합니다. S가 Required를 만족하지 않으면 호출 시 타입 오류가 발생합니다.

// Only a Builder whose S includes url and method
// can legally invoke build().

설정 메서드를 상태에 연결하기

각 설정 메서드는 이전과 같이 S를 확장합니다. 두 필수 설정 메서드가 모두 실행되면 S가 마침내 Required를 확장하고 build를 호출할 수 있게 됩니다.

class Builder<S> {
  private d: Record<string, unknown> = {};
  url(u: string): Builder<S & { url: string }> { this.d.url = u; return this as any; }
  method(m: string): Builder<S & { method: string }> { this.d.method = m; return this as any; }
  build(this: Builder<{ url: string; method: string }>): Config { return this.d as Config; }
}

정상 경로는 컴파일됩니다

두 필수 단계가 모두 포함되면 연쇄 호출의 타입 검사가 통과하고 실행됩니다. 컴파일러는 S에 모든 필수 키가 포함되어 있음을 확인할 수 있습니다.

const cfg = new Builder<{}>().url("/x").method("GET").build();
console.log(cfg.url, cfg.method);

오류 경로는 실패합니다

필수 단계를 하나 생략하면 빌더의 S가 Required를 확장하지 않으므로 build()의 타입 검사가 더 이상 통과하지 않습니다. 이 실수는 컴파일 시점에 발견됩니다.

// const bad = new Builder<{}>().url("/x").build();
// Error: 'build' can only be called when method is set too.

실행 시점 보호보다 나은 이유

실행 시점의 if (!this.url) throw 검사는 코드가 실행될 때에만 실패합니다. this 매개변수 방식은 타입 검사 중에 실패하므로, 완전하지 않은 빌드는 절대 배포되지 않습니다.

선택적 필드는 계속 선택적입니다

timeout과 같은 선택적 단계는 Required에 포함되지 않으므로 build()를 제한하지 않습니다. 자유롭게 포함하거나 건너뛸 수 있습니다.

const ok = new Builder<{}>().method("PUT").url("/y").build();
console.log("order of required steps does not matter");

많은 요구 사항으로 확장하기

Required 구조와 this 매개변수에 필수 키를 더 추가하면 컴파일러가 모든 키를 강제합니다. 이 패턴은 필수 단계의 수와 관계없이 확장할 수 있습니다.

제한 사항

이 보장은 모든 설정 메서드에서 S를 일관되게 전달하고 this 매개변수 타입을 사용하는 경우에만 성립합니다. 호출자가 완전히 타입 안전성을 유지하도록 형변환은 설정 메서드 안에만 제한해야 합니다.

간단히 확인하기

이 수업을 간단히 확인합니다.

복습

필수 단계 강제를 위해 build를 this: Builder<Required> 매개변수와 함께 타입 지정합니다. 누적된 상태 S에 모든 필수 키가 포함된 경우에만 메서드의 타입 검사가 통과하므로, 완전하지 않은 객체 생성을 컴파일 오류로 바꿀 수 있습니다.

자주 묻는 질문

“필수 단계 강제하기” 강의는 무료인가요?

네 — “필수 단계 강제하기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 TypeScript Academy 강의 전체를 잠금 해제할 수 있습니다. TypeScript Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“필수 단계 강제하기”에서 뭘 배우나요?

필수 필드가 모두 설정될 때까지 build()를 실행하지 못하게 합니다. 브라우저에서 직접 실행하는 실습 코드로 TypeScript Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

TypeScript Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 TypeScript Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.

“필수 단계 강제하기” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 TypeScript Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 TypeScript Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← TypeScript Academy(으)로 돌아가기