0Pricing
TypeScript Academy · 강의

이벤트 맵에 타입 지정하기

이벤트 이름을 해당 페이로드 타입에 매핑합니다.

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

이벤트 맵이란 무엇인가요

이벤트 맵은 각 이벤트 이름을 해당 페이로드의 형태에 연결하는 인터페이스입니다. 이벤트 시스템을 위한 단일 진실 공급원입니다.

interface Events {
  login: { userId: string };
  logout: void;
}
// "login" carries a payload; "logout" carries none.

이름을 페이로드에 매핑하기

각 속성 키는 이벤트 이름이고 그 값의 타입은 페이로드입니다. 이를 통해 타입 시스템은 각 이벤트가 정확히 어떤 데이터를 요구하는지 알 수 있습니다.

interface Events {
  message: { text: string; from: string };
  typing: { userId: string };
}
const sample: Events["message"] = { text: "hi", from: "ada" };
console.log(sample.text, sample.from);

페이로드가 없는 Events

일부 이벤트는 데이터를 전달하지 않습니다. 전달할 데이터가 없음을 나타내려면 void(또는 빈 객체)로 모델링합니다.

interface Events {
  open: void;
  close: void;
}
// Handlers for these receive no meaningful argument.
console.log("payloadless events use void");

이벤트 이름 타입 추출하기

keyof를 사용하면 맵에서 유효한 모든 이벤트 이름의 유니온을 가져올 수 있으며, 함수 매개변수를 제한할 때 유용합니다.

interface Events {
  login: { userId: string };
  logout: void;
}
type EventName = keyof Events; // "login" | "logout"
const e: EventName = "login";
console.log(e);

페이로드 타입 조회하기

이벤트 이름으로 맵을 인덱싱하면 해당 이벤트의 페이로드 타입을 가져올 수 있습니다. Events["login"]은 { userId: string }입니다.

interface Events {
  login: { userId: string };
  logout: void;
}
type LoginPayload = Events["login"]; // { userId: string }
const p: LoginPayload = { userId: "u1" };
console.log(p.userId);

더 풍부한 이벤트 맵

실제 앱에는 이벤트가 많습니다. 각 이벤트의 페이로드 계약을 한곳에서 명확히 정의하므로, 생성자와 소비자가 항상 일치합니다.

interface Events {
  cartAdd: { productId: string; qty: number };
  cartRemove: { productId: string };
  checkout: { total: number };
}
const a: Events["cartAdd"] = { productId: "p1", qty: 2 };
console.log(a.productId, a.qty);

페이로드는 유니온일 수 있습니다

페이로드 타입 자체가 판별 유니온일 수 있으므로, 하나의 이벤트가 서로 관련된 여러 형태를 전달할 수 있습니다.

interface Events {
  status:
    | { kind: "online" }
    | { kind: "offline"; since: number };
}
const s: Events["status"] = { kind: "offline", since: 100 };
console.log(s.kind);

페이로드 타입 재사용하기

페이로드 타입을 별도로 정의한 다음 맵에서 참조할 수 있으므로 인터페이스를 깔끔하게 유지하고 형태를 재사용할 수 있습니다.

type User = { id: string; name: string };
interface Events {
  userCreated: User;
  userDeleted: { id: string };
}
const u: Events["userCreated"] = { id: "1", name: "Ada" };
console.log(u.name);

제약 없는 문자열보다 맵이 나은 이유

맵이 없으면 이벤트 이름은 단순한 문자열이고 페이로드는 any입니다. 맵을 사용하면 자동 완성, 검증, 계약을 얻을 수 있습니다.

// Loose: emit("login", { usrId: "x" }) typo unnoticed, payload any
// Mapped: the interface forces the correct name and payload shape.
console.log("the map is the contract");

맵이 API를 이끕니다

다음 레슨에서는 emit과 on이 이벤트 맵을 기준으로 제네릭화되고, keyof와 인덱스 접근을 사용하여 타입 안전성을 유지합니다.

interface Events {
  login: { userId: string };
  logout: void;
}
type Name = keyof Events;
type PayloadOf<K extends Name> = Events[K];
const id: PayloadOf<"login"> = { userId: "u" };
console.log(id.userId);

단일 진실 공급원

모든 것이 이벤트 맵에서 파생되므로 한곳에서 페이로드를 변경하면 이를 사용하는 모든 emit과 핸들러가 업데이트됩니다.

interface Events {
  ping: { at: number };
}
const p: Events["ping"] = { at: Date.now() };
console.log(typeof p.at);

빠른 확인: 이벤트 맵

이벤트 맵의 타입 지정에 대한 이해도를 확인해 보십시오.

복습: 이벤트 맵 타입 지정

이벤트를 이름과 페이로드를 매핑하는 인터페이스로 모델링하고, 페이로드가 없는 이벤트에는 void를, 이름에는 keyof를, 페이로드 타입에는 인덱스 접근을 사용하는 방법을 배웠습니다. 이는 타입 안전한 이벤트 시스템의 기반입니다.

interface Events { login: { userId: string }; logout: void }
type Name = keyof Events;
const n: Name = "logout";
console.log(n);

자주 묻는 질문

“이벤트 맵에 타입 지정하기” 강의는 무료인가요?

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

“이벤트 맵에 타입 지정하기”에서 뭘 배우나요?

이벤트 이름을 해당 페이로드 타입에 매핑합니다. 브라우저에서 직접 실행하는 실습 코드로 TypeScript Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

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

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

“이벤트 맵에 타입 지정하기” 강의는 얼마나 걸리나요?

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

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

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

이 강의의 모든 강의

  1. 이벤트 맵에 타입 지정하기
  2. 타입 안전한 emit과 on
  3. 제네릭 이벤트 이미터 클래스
  4. 리스너 인수 추론
← TypeScript Academy(으)로 돌아가기