TypeScript Academy · Lekcja

reflect-metadata i typy Design

Przechwytuj typy parametrów i właściwości w czasie wykonywania

reflect-metadata i typy Design to bezpłatna lekcja TypeScript Academy na CoddyKit. To lekcja 3 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej TypeScript Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs TypeScript Academy zawiera 4 lekcji w sumie.

reflect-metadata i typy projektowe

Zanim powstał ustandaryzowany mechanizm metadanych, TypeScript mógł emitować w czasie działania informacje o typach dostępne w czasie kompilacji za pośrednictwem biblioteki reflect-metadata oraz opcji kompilatora emitDecoratorMetadata. Ta lekcja omawia ten starszy, ale wciąż powszechnie używany mechanizm.

Włączanie funkcji

Wymagane są dwie rzeczy: włączenie opcji kompilatora oraz jednorazowe zaimportowanie biblioteki w punkcie wejścia programu.

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

import "reflect-metadata";

Co jest emitowane

Przy włączonej opcji emitDecoratorMetadata kompilator emituje trzy klucze dla dekorowanych elementów: design:type, design:paramtypes i design:returntype. Wartościami są funkcje konstruktorów, na przykład String i Number.

Odczytywanie design:type

W przypadku dekorowanej właściwości Reflect.getMetadata("design:type", target, key) zwraca konstruktor typu właściwości.

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;
}

Odczytywanie design:paramtypes

W konstruktorze lub metodzie design:paramtypes jest tablicą konstruktorów typów parametrów, stanowiącą podstawę wstrzykiwania zależności.

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) {}
}

Ograniczenia emitowanych typów

Zachowują się tylko proste typy, które można reprezentować w czasie działania. Interfejsy, unie i typy generyczne zostają zredukowane do Object, ponieważ nie mają konstruktora dostępnego w czasie działania. Typy projektowe są przybliżeniem, a nie pełnym typem TS.

Własne metadane za pomocą Reflect

Można również definiować własne klucze metadanych za pomocą Reflect.defineMetadata, niezależnie od typów projektowych.

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;
}

Gdzie jest to używane

Ten mechanizm napędza wiele uznanych frameworków (NestJS, TypeORM, class-validator). Odczytują one design:type i design:paramtypes, aby konfigurować zależności i walidować wartości bez konieczności ponownego deklarowania przez Państwa typów.

reflect-metadata a standardowe metadane

Nowy interfejs API Symbol.metadata jest częścią języka i nie emituje typów projektowych. reflect-metadata jako jedyne dostarcza informacje o typach, ale jest powiązane z eksperymentalnym trybem dekoratorów. W projekcie należy wybrać jeden z tych modeli.

Kolejność importowania ma znaczenie

import "reflect-metadata" musi wykonać się raz, przed ewaluacją jakiejkolwiek dekorowanej klasy, ponieważ rozszerza globalny obiekt Reflect o funkcje metadanych. Należy zaimportować je na samym początku pliku wejściowego.

Dlaczego ma to znaczenie

Emitowanie typów projektowych pozwala frameworkom połączyć typy z czasu kompilacji z zachowaniem w czasie działania, co umożliwia wygodne wstrzykiwanie zależności i walidację. Znajomość ograniczeń tego mechanizmu (brak interfejsów i typów generycznych) zapobiega nieoczekiwanym wynikom Object.

Szybkie sprawdzenie

Sprawdź swoje rozumienie biblioteki reflect-metadata.

Podsumowanie

Przy włączonych opcjach experimentalDecorators i emitDecoratorMetadata oraz wczesnym import "reflect-metadata" kompilator emituje design:type i design:paramtypes jako konstruktory dostępne w czasie działania. Frameworki odczytują je na potrzeby wstrzykiwania zależności i walidacji, choć interfejsy, unie i typy generyczne zostają zredukowane do Object.

Często zadawane pytania

Czy lekcja „reflect-metadata i typy Design” jest bezpłatna?

Tak — pełny tekst „reflect-metadata i typy Design” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu TypeScript Academy, przejdź na CoddyKit PRO. Kurs TypeScript Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „reflect-metadata i typy Design”?

Przechwytuj typy parametrów i właściwości w czasie wykonywania Ćwiczysz TypeScript Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć TypeScript Academy?

Nie wymagamy żadnego doświadczenia. TypeScript Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 3 z 4.

Ile czasu zajmuje lekcja „reflect-metadata i typy Design”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji TypeScript Academy?

Tak. Każda lekcja TypeScript Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

← Powrót do TypeScript Academy