React Academy · 강의

컴포넌트 변형을 위한 판별된 유니언

판별된 유니언으로 변형 속성을 모델링해 TypeScript가 유효한 속성 조합을 강제하도록 합니다.

레슨 1/413개 단계

컴포넌트 변형을 위한 판별된 유니언은(는) CoddyKit의 무료 React Academy 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 React Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. React Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

변형 프롭의 문제

여러 모드를 위한 선택적 프롭을 가진 컴포넌트(예: 링크 또는 버튼 중 하나로 동작하는 버튼)는 잘못된 프롭 조합을 허용할 수 있습니다. 판별 유니온 없이는 TypeScript가 이를 잡아내지 못합니다.

판별 유니온이란 무엇입니까

판별 유니온은 공통 리터럴 타입 필드(판별자)를 공유하는 타입들의 유니온입니다. TypeScript는 해당 필드의 값에 따라 타입의 범위를 좁힙니다.

type Shape =
  | { kind: 'circle'; radius: number }
  | { kind: 'rectangle'; width: number; height: number };

function area(shape: Shape): number {
  if (shape.kind === 'circle') return Math.PI * shape.radius ** 2;
  return shape.width * shape.height; // TS knows width/height exist here
}

Button과 링크 변형

as 또는 variant 필드에 판별 유니온을 사용하여 다형성 컴포넌트를 모델링하면 각 경우에 올바른 프롭을 적용할 수 있습니다.

type ButtonProps =
  | { as: 'button'; onClick: () => void; disabled?: boolean; children: React.ReactNode }
  | { as: 'a'; href: string; target?: string; children: React.ReactNode };

function ActionButton(props: ButtonProps) {
  if (props.as === 'button') {
    return <button onClick={props.onClick} disabled={props.disabled}>{props.children}</button>;
  }
  return <a href={props.href} target={props.target}>{props.children}</a>;
}

알림 컴포넌트 변형

심각도 유형마다 필요한 데이터가 다르도록 알림을 모델링하십시오.

type AlertProps =
  | { type: 'success'; message: string }
  | { type: 'error'; message: string; onRetry: () => void }
  | { type: 'warning'; message: string; details?: string };

function Alert(props: AlertProps) {
  if (props.type === 'error') {
    return (
      <div className="alert error">
        <p>{props.message}</p>
        <button onClick={props.onRetry}>Retry</button>
      </div>
    );
  }
  return <div className={`alert ${props.type}`}>{props.message}</div>;
}

이벤트 처리기에서 범위 좁히기

판별 유니온은 이벤트 기반 데이터에도 적용됩니다. 상태 머신이나 액션 기반 상태에 특히 유용합니다.

type LoadingState<T> =
  | { status: 'idle' }
  | { status: 'loading' }
  | { status: 'success'; data: T }
  | { status: 'error'; error: Error };

function DataView<T>({ state }: { state: LoadingState<T> }) {
  if (state.status === 'loading') return <Spinner />;
  if (state.status === 'error') return <p>{state.error.message}</p>;
  if (state.status === 'success') return <pre>{JSON.stringify(state.data)}</pre>;
  return null;
}

never를 사용한 모든 경우 검사

기본 분기에 never 검사를 추가하면 새 유니온 구성원이 추가되었지만 처리되지 않은 경우 TypeScript 오류를 확인할 수 있습니다.

function assertNever(x: never): never {
  throw new Error('Unhandled case: ' + x);
}

function renderIcon(type: AlertProps['type']) {
  switch (type) {
    case 'success': return <CheckIcon />;
    case 'error': return <XIcon />;
    case 'warning': return <WarnIcon />;
    default: return assertNever(type); // TS error if a case is missing
  }
}

API 응답을 위한 판별 유니온

API 응답 형태를 판별 유니온으로 모델링하면 호출 측에서 형 변환 없이 성공 경로와 오류 경로를 처리할 수 있습니다.

type ApiResult<T> =
  | { ok: true; data: T }
  | { ok: false; error: string; code: number };

async function fetchUser(id: string): Promise<ApiResult<User>> {
  const res = await fetch(`/api/users/${id}`);
  if (!res.ok) return { ok: false, error: 'Not found', code: res.status };
  return { ok: true, data: await res.json() };
}

범위 좁히기를 위한 타입 가드

판별자가 단순한 동등성 검사가 아닌 더 복잡한 상황에서 유니온의 범위를 좁히려면 사용자 지정 타입 가드를 사용하십시오.

function isSuccess<T>(result: ApiResult<T>): result is { ok: true; data: T } {
  return result.ok === true;
}

const result = await fetchUser('1');
if (isSuccess(result)) {
  console.log(result.data.name); // TS knows data exists
}

선택적 프롭이 지나치게 늘어나는 문제 피하기

판별 유니온이 없으면 특정 조합에서만 유효한 선택적 프롭이 컴포넌트에 계속 쌓여 혼란스럽고 타입 지정도 되지 않습니다. 판별 유니온은 불가능한 상태를 제거합니다.

// Bad: optional prop soup — invalid combos allowed:
interface BadProps {
  href?: string;
  onClick?: () => void;
  disabled?: boolean;
}

// Good: only valid combos via discriminated union:
type GoodProps =
  | { as: 'a'; href: string }
  | { as: 'button'; onClick: () => void; disabled?: boolean };

유니온 조합하기

&(교차 타입)를 사용하여 유니온의 모든 구성원에 공통 프롭을 추가하십시오.

type BaseProps = { className?: string; children: React.ReactNode };

type ButtonVariant =
  | (BaseProps & { variant: 'primary'; onClick: () => void })
  | (BaseProps & { variant: 'link'; href: string });

실행 시 판별

리액트는 실행 시 판별자를 사용하여 올바른 UI를 렌더링합니다. TypeScript는 컴파일 시 판별자를 사용하여 올바른 프롭 사용을 강제합니다. 두 계층 모두 보호됩니다.

빠른 확인

판별 유니온에서 판별자는 무엇입니까?

복습

판별 유니온은 리터럴 타입으로 지정된 판별자 필드를 공유하여 상호 배타적인 프롭 집합을 가진 컴포넌트를 모델링합니다. 모든 경우를 검사하려면 기본 분기에 never를 사용하십시오. 판별 유니온은 선택적 프롭이 허용하는 잘못된 프롭 조합을 제거하여 컴포넌트 자체가 문서 역할을 하면서 타입 안전성을 갖추게 합니다.

무료로 시작

AI 튜터와 함께 React을(를) 배우세요 — 무료

브라우저에서 실제 코드를 작성하고 실행하며, 24/7 AI 튜터로부터 즉각적인 도움을 받고, 웹이나 앱에서 중단한 부분부터 계속 학습하세요.

코스
88
레슨
324

자주 묻는 질문

“컴포넌트 변형을 위한 판별된 유니언” 강의는 무료인가요?

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

“컴포넌트 변형을 위한 판별된 유니언”에서 뭘 배우나요?

판별된 유니언으로 변형 속성을 모델링해 TypeScript가 유효한 속성 조합을 강제하도록 합니다. 브라우저에서 직접 실행하는 실습 코드로 React Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

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

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

“컴포넌트 변형을 위한 판별된 유니언” 강의는 얼마나 걸리나요?

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

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

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

이 강의의 모든 강의

  1. 컴포넌트 변형을 위한 판별된 유니언
  2. React의 조건부 형식과 매핑된 형식
  3. 'as' 속성을 사용하는 다형성 컴포넌트
  4. 형식이 안전한 양식과 API 응답 계약
← React Academy(으)로 돌아가기