TypeScript Academy · 강의

reflect-metadata와 설계 타입

런타임에 매개변수와 속성 타입을 가져옵니다.

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

reflect-metadata와 설계 타입

표준화된 메타데이터가 존재하기 전에는 TypeScript가 reflect-metadata 라이브러리와 emitDecoratorMetadata 컴파일러 플래그를 사용해 컴파일 시점의 타입 정보를 실행 중에 방출할 수 있었습니다. 이 레슨에서는 오래되었지만 여전히 널리 사용되는 이 방식을 다룹니다.

기능 활성화

두 가지가 필요합니다. 컴파일러 옵션을 활성화하고 프로그램 진입점에서 라이브러리를 한 번 가져와야 합니다.

// tsconfig.json
// {
//   "compilerOptions": {
//     "experimentalDecorators": true,
//     "emitDecoratorMetadata": true
//   }
// }

import "reflect-metadata";

방출되는 내용

emitDecoratorMetadata를 사용하면 컴파일러는 데코레이터가 적용된 멤버에 대해 세 가지 키를 방출합니다. design:type, design:paramtypes, design:returntype입니다. 값은 생성자 함수입니다(예: String, Number).

design:type 읽기

데코레이터가 적용된 속성에서 Reflect.getMetadata("design:type", target, key)는 속성 타입의 생성자를 반환합니다.

import "reflect-metadata";

function track(target: any, key: string) {
  const t = Reflect.getMetadata("design:type", target, key);
  console.log(key, "->", t.name); // e.g. "name -> String"
}

class Person {
  @track name!: string;
  @track age!: number;
}

design:paramtypes 읽기

생성자나 메서드에서 design:paramtypes는 매개변수 타입 생성자의 배열이며, 의존성 주입의 기반이 됩니다.

function injectable(target: any) {
  const params = Reflect.getMetadata("design:paramtypes", target);
  console.log(params.map((p: any) => p.name)); // ["Database", "Logger"]
}

@injectable
class Service {
  constructor(private db: Database, private log: Logger) {}
}

방출된 타입의 한계

실행 중에 표현할 수 있는 단순한 타입만 남습니다. 인터페이스, 유니온, 제네릭은 실행 중 생성자가 없으므로 Object로 축소됩니다. 설계 타입은 전체 TS 타입이 아니라 근사치입니다.

Reflect를 사용한 사용자 지정 메타데이터

설계 타입과 관계없이 Reflect.defineMetadata를 사용해 자체 메타데이터 키를 정의할 수도 있습니다.

import "reflect-metadata";

function required(target: any, key: string) {
  Reflect.defineMetadata("required", true, target, key);
}

function isRequired(target: any, key: string) {
  return Reflect.getMetadata("required", target, key) === true;
}

사용되는 곳

이 방식은 여러 기존 프레임워크(NestJS, TypeORM, class-validator)의 기반이 됩니다. 이러한 프레임워크는 design:type과 design:paramtypes를 읽어 타입을 다시 작성하지 않아도 의존성을 연결하고 값을 검증합니다.

reflect-metadata와 표준 메타데이터 비교

새로운 Symbol.metadata API는 언어의 일부이며 설계 타입을 방출하지 않습니다. reflect-metadata는 타입 정보를 제공한다는 점에서 독특하지만 실험적 데코레이터 모드에 종속됩니다. 프로젝트마다 하나의 모델을 선택해 사용하세요.

가져오기 순서의 중요성

import "reflect-metadata"는 데코레이터가 적용된 클래스가 평가되기 전에 한 번만 실행되어야 합니다. 메타데이터 함수를 사용하도록 전역 Reflect 객체를 수정하기 때문입니다. 진입 파일의 가장 위에서 가져오세요.

중요한 이유

설계 타입을 방출하면 프레임워크가 컴파일 시점의 타입과 실행 중 동작 사이의 간극을 연결할 수 있으며, 이는 편리한 DI와 유효성 검사를 가능하게 하는 핵심 요소입니다. 인터페이스와 제네릭을 지원하지 않는다는 한계를 알면 예상치 못한 Object 결과를 방지할 수 있습니다.

빠른 확인

reflect-metadata를 제대로 이해했는지 확인해 보세요.

복습

experimentalDecorators와 emitDecoratorMetadata를 활성화하고 import "reflect-metadata"를 초기에 실행하면, 컴파일러는 design:type과 design:paramtypes를 실행 중 생성자로 방출합니다. 프레임워크는 이를 DI와 유효성 검사에 사용하지만, 인터페이스·유니온·제네릭은 Object로 축소됩니다.

자주 묻는 질문

“reflect-metadata와 설계 타입” 강의는 무료인가요?

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

“reflect-metadata와 설계 타입”에서 뭘 배우나요?

런타임에 매개변수와 속성 타입을 가져옵니다. 브라우저에서 직접 실행하는 실습 코드로 TypeScript Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

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

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

“reflect-metadata와 설계 타입” 강의는 얼마나 걸리나요?

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

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

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

이 강의의 모든 강의

← TypeScript Academy(으)로 돌아가기