0Pricing
TypeScript Academy · 강의

로케일 인식 타입 추론

모든 로케일이 동일한 키 구조를 공유하도록 보장합니다.

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

로캘 인식 타입 추론

앱은 여러 로캘(en, tr, de...)을 제공합니다. 기준 로캘에 있는 키가 어느 로캘에서든 누락되면 오류가 발생하는 타입을 만들어 번역이 조용히 서로 어긋나지 않게 하려고 합니다.

기준 로캘

하나의 로캘(보통 en)을 표준 키 구조로 선택합니다. 다른 모든 로캘은 그 형태와 일치해야 합니다.

const en = {
  greeting: "Hello",
  cart: { empty: "Empty", checkout: "Checkout" },
} as const;

type Base = typeof en;

다른 로캘 제한하기

각 추가 로캘에 기준 구조를 타입으로 지정합니다. 이제 해당 로캘 파일에서 키가 누락되면 컴파일 오류가 발생합니다.

const tr: Base = {
  greeting: "Merhaba",
  cart: { empty: "Bo\u015f", checkout: "\u00d6deme" },
};
// Omitting cart.checkout -> Error: property missing

추가 키도 찾아내기

기준 타입을 타입 주석으로 사용하면 로캘에는 있지만 기준에는 없는 알 수 없는 키도 표시됩니다. 따라서 남아 있는 항목이나 철자가 잘못된 항목을 찾아낼 수 있습니다.

const de: Base = {
  greeting: "Hallo",
  cart: { empty: "Leer", checkout: "Kasse" },
  extra: "oops", // Error: not in Base
};

로캘 정의 도우미

제네릭 도우미는 각 값을 그대로 보존하면서 구조를 강제하므로, 로캘별 정의 위치를 깔끔하게 만들 수 있습니다.

function defineLocale<T extends Base>(loc: T): T {
  return loc;
}

const fr = defineLocale({
  greeting: "Bonjour",
  cart: { empty: "Vide", checkout: "Paiement" },
});

모든 로캘의 등록부

locales를 레코드에 모읍니다. 각 값을 Base로 제한하면 앱 전체에서 일관된 구조가 보장됩니다.

const locales: Record<string, Base> = { en, tr, de: fr };
// every entry must have the full Base key structure

타입 수준 동등성(깊은 비교)

더 엄격하게 보장하려면 키 구조를 깊이 비교하고 서로 다를 때 오류 타입으로 해석되는 SameKeys 타입을 만들 수 있습니다. 이는 단순한 타입 주석으로 감지할 수 있는 범위를 넘어섭니다.

type SameKeys<A, B> =
  keyof A extends keyof B
    ? keyof B extends keyof A ? true : false
    : false;

키 한 번만 도출하기

모든 로캘이 Base를 공유하므로 키 경로 타입(앞선 수업에서 다룬 내용)은 Base에서 한 번만 계산하고 모든 로캘에서 재사용합니다. 따라서 t의 타입 지정은 로캘과 무관합니다.

type Key = LeafPaths<Base>;
// same valid keys regardless of active locale

실행 시 로캘 선택

실행 시 활성 로캘로 등록부를 인덱싱합니다. 타입 시스템이 이미 각 로캘에 동일한 키가 있음을 보장하므로 조회가 안전합니다.

function translate(locale: keyof typeof locales, key: Key): string {
  return getPath(locales[locale], key);
}

로캘 간 누락 키 찾기

모든 파일에 직접 타입 주석을 달 수 없다면(예: JSON 가져오기), 빌드 시점에 가져온 각 로캘을 Base와 비교하는 타입 검사를 수행하여 누락된 키를 나열하는 차이 타입을 보여 줄 수 있습니다.

type Missing<L> = Exclude<keyof Base, keyof L>;
type TrMissing = Missing<typeof tr>; // never if complete

이 내용이 중요한 이유

타입이 지정되지 않은 국제화는 점점 어긋납니다. en에 추가한 키를 de에서 빠뜨리면 빈 문자열이나 영어 문자열이 배포됩니다. 모든 로캘을 공유 기준에 맞추면 이러한 누락이 컴파일 오류로 바뀌어 모든 로캘을 완전하고 일관되게 유지할 수 있습니다.

빠른 점검

로캘 인식 타입 추론을 이해했는지 확인해 보세요.

복습

기준 로캘을 표준 구조로 선택하고 다른 모든 로캘을 그 구조에 맞추었으므로, 키가 누락되거나 추가되면 컴파일되지 않습니다. defineLocale 도우미와 제한된 등록부가 모든 로캘을 구조적으로 동일하게 유지하며, 키 경로는 기준에서 한 번만 도출됩니다.

자주 묻는 질문

“로케일 인식 타입 추론” 강의는 무료인가요?

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

“로케일 인식 타입 추론”에서 뭘 배우나요?

모든 로케일이 동일한 키 구조를 공유하도록 보장합니다. 브라우저에서 직접 실행하는 실습 코드로 TypeScript Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

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

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

“로케일 인식 타입 추론” 강의는 얼마나 걸리나요?

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

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

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

이 강의의 모든 강의

  1. 번역 키에 타입 지정하기
  2. 보간 타입 안전성
  3. 타입을 활용한 복수형 처리
  4. 로케일 인식 타입 추론
← TypeScript Academy(으)로 돌아가기