0Pricing
TypeScript Academy · 강의

구조화된 문자열 모델링

이벤트 이름과 경로 같은 형식을 강제합니다.

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

문자열 형식 적용하기

실제 앱에서 많은 문자열은 일정한 구조를 따릅니다. 이벤트 처리기 이름, API 경로, CSS 변수 등이 그 예입니다. 템플릿 리터럴 타입을 사용하면 이러한 형식을 모델링하여 컴파일러가 강제하도록 만들 수 있습니다.

이벤트 처리기 이름 모델링

처리기 이름은 대개 on 뒤에 대문자로 시작하는 이벤트 이름이 오는 형태입니다. 템플릿 안에서 내장 Capitalize 도우미를 사용하면 'click' 이벤트가 'onClick' 처리기 이름으로 변환됩니다.

type Event = "click" | "focus"
// template: on followed by Capitalize of Event
// => "onClick" | "onFocus"
const h: "onClick" | "onFocus" = "onClick"
console.log(h)

여기서 Capitalize가 중요한 이유

Capitalize가 없으면 템플릿은 'onclick'을 생성합니다. 이 내장 타입은 리터럴의 첫 문자를 대문자로 바꾸어 관용적인 camelCase 처리기 이름을 만듭니다.

type E = "scroll"
type Cap = Capitalize<E> // "Scroll"
const c: "Scroll" = "Scroll"
console.log(c)

처리기 맵 생성하기

템플릿 리터럴 키를 매핑된 타입과 결합하면 처리기로 이루어진 객체 타입을 생성할 수 있습니다. 이벤트마다 타입이 지정된 함수가 하나씩 생기며 이름의 대소문자도 올바르게 적용됩니다.

type Events = "click" | "hover"
type Handlers = {
  [E in Events as "on" extends string ? "on" : never]?: () => void
}
// In practice the key uses a template: on + Capitalize<E>
const h: { onClick?: () => void } = {}
console.log(h)

경로 모델링

API 경로는 앞에 슬래시가 오고, 리소스와 식별자 구간이 이어지는 형태를 공유합니다. 고정된 텍스트와 자리 표시자를 결합한 템플릿으로 유효한 경로를 표현할 수 있습니다.

type Resource = "users" | "posts"
// template: /api/ followed by Resource
// => "/api/users" | "/api/posts"
const path: "/api/users" | "/api/posts" = "/api/users"
console.log(path)

매개변수가 있는 경로

동적 식별자를 위한 자리 표시자를 추가하세요. 슬래시, 리소스, 슬래시, 제네릭 식별자 구간으로 이루어진 템플릿은 숫자 식별자가 뒤따르는 사용자 경로와 같은 경로를 모델링합니다.

type Id = number
// template: /users/ followed by Id-like segment
function userPath(id: number): string {
  return "/users/" + id
}
console.log(userPath(42)) // /users/42

컴파일 시점에 형식 적용하기

매개변수의 타입을 템플릿 리터럴 타입으로 지정하면 구조에 맞지 않는 모든 문자열을 거부할 수 있습니다. 이는 잘못된 경로나 키를 막는 안전장치입니다.

type Method = "GET" | "POST"
function call(endpoint: "GET /users" | "POST /users") {
  return endpoint
}
console.log(call("GET /users"))
// call("DELETE /users") // Error
console.log("ok")

CSS 변수 이름 조합하기

CSS 사용자 정의 속성은 이름 지정 규칙을 따릅니다. 앞에 대시 두 개를 붙이고 토큰 자리 표시자를 사용하는 템플릿으로 색상 토큰 변수와 같은 이름을 모델링할 수 있습니다.

type Token = "primary" | "accent"
// template: --color- followed by Token
// => "--color-primary" | "--color-accent"
const v: "--color-primary" | "--color-accent" = "--color-accent"
console.log(v)

추론을 사용한 분할

템플릿 리터럴 타입은 구문 분석에도 사용할 수 있습니다. 조건부 타입과 infer를 사용하면 타입 수준에서 구조화된 문자열의 일부를 추출할 수 있습니다. 예를 들어 엔드포인트 문자열에서 메서드를 가져올 수 있습니다.

type ExtractMethod<S> = S extends "GET /users" ? "GET" : "OTHER"
type M = ExtractMethod<"GET /users"> // "GET"
const m: "GET" = "GET"
console.log(m)

실제 활용 효과

구조화된 문자열 타입은 다양한 버그를 한꺼번에 찾아냅니다. 철자가 틀린 처리기 이름, 알 수 없는 경로, 잘못된 CSS 토큰이 모두 조용히 런타임에 실패하는 대신 컴파일 오류가 됩니다.

type Tab = "home" | "profile"
// template: tab- followed by Tab => "tab-home" | "tab-profile"
function selectTab(id: "tab-home" | "tab-profile") { return id }
console.log(selectTab("tab-home"))

읽기 쉽게 유지하기

템플릿 타입은 강력하지만 지나치게 깊게 중첩하면 가독성이 떨어집니다. 중간 타입 별칭에 이름을 지정하여 다음에 읽는 사람도 구조를 명확히 이해할 수 있게 하세요.

type Entity = "user" | "order"
// type EventName = on + Capitalize<Entity> + Created
// e.g. "onUserCreated" | "onOrderCreated"
const e: "onUserCreated" | "onOrderCreated" = "onUserCreated"
console.log(e)

빠른 확인

구조화된 문자열 모델링에 대한 이해도를 확인해 보세요.

복습

템플릿 리터럴 타입은 처리기 이름(on과 이벤트의 Capitalize 결합), 경로, CSS 변수처럼 구조화된 문자열을 모델링하고 컴파일 시점에 형식을 적용합니다. 매핑된 타입과 결합하면 처리기 맵을 생성할 수 있고, 조건부 타입 및 infer와 결합하면 문자열을 구문 분석할 수 있습니다. 복잡한 패턴을 읽기 쉽게 유지하려면 중간 별칭에 이름을 지정하세요.

자주 묻는 질문

“구조화된 문자열 모델링” 강의는 무료인가요?

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

“구조화된 문자열 모델링”에서 뭘 배우나요?

이벤트 이름과 경로 같은 형식을 강제합니다. 브라우저에서 직접 실행하는 실습 코드로 TypeScript Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

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

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

“구조화된 문자열 모델링” 강의는 얼마나 걸리나요?

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

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

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

이 강의의 모든 강의

  1. 템플릿 리터럴 타입 기초
  2. 구조화된 문자열 모델링
  3. 문자열 유니언과 자동 완성
  4. 내장 문자열 조작 타입
← TypeScript Academy(으)로 돌아가기