TypeScript Academy · Lezione

reflect-metadata e design type

Acquisisca a runtime i tipi dei parametri e delle proprietà.

reflect-metadata e design type è una lezione TypeScript Academy gratuita su CoddyKit. Questa è la lezione 3 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento TypeScript Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso TypeScript Academy include 4 lezioni in totale.

reflect-metadata e i tipi in fase di progettazione

Prima che esistesse uno standard per i metadati, TypeScript poteva emettere a runtime informazioni sui tipi in fase di progettazione tramite la libreria reflect-metadata e l'opzione del compilatore emitDecoratorMetadata. Questa lezione tratta questo meccanismo meno recente, ma ancora ampiamente utilizzato.

Abilitazione della funzionalità

Sono necessarie due operazioni: attivare le opzioni del compilatore e importare una volta la libreria nel punto di ingresso del programma.

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

import "reflect-metadata";

Cosa viene emesso

Con emitDecoratorMetadata, il compilatore emette tre chiavi per i membri decorati: design:type, design:paramtypes e design:returntype. I valori sono funzioni costruttrici, ad esempio String e Number.

Lettura di design:type

Per una proprietà decorata, Reflect.getMetadata("design:type", target, key) restituisce il costruttore del tipo della proprietà.

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

Lettura di design:paramtypes

Su un costruttore o un metodo, design:paramtypes è un array dei costruttori dei tipi dei parametri, alla base dell'iniezione delle dipendenze.

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

Limitazioni dei tipi emessi

Sopravvivono solo i tipi semplici rappresentabili a runtime. Interfacce, unioni e generici diventano Object perché non hanno un costruttore a runtime. I tipi di progettazione sono approssimativi e non corrispondono all'intero tipo TS.

Metadati personalizzati con Reflect

È anche possibile definire chiavi di metadati personalizzate con Reflect.defineMetadata, indipendentemente dai tipi di progettazione.

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

Dove viene utilizzato

Questo meccanismo è alla base di molti framework consolidati, tra cui NestJS, TypeORM e class-validator. Questi framework leggono design:type e design:paramtypes per collegare le dipendenze e validare i valori senza richiedere di ripetere i tipi.

reflect-metadata e i metadati standard

La nuova API Symbol.metadata fa parte del linguaggio e non emette i tipi di progettazione. reflect-metadata fornisce in modo esclusivo informazioni sui tipi, ma è legata alla modalità sperimentale dei decoratori. Scelga un solo modello per progetto.

L'ordine degli import è importante

import "reflect-metadata" deve essere eseguito una sola volta, prima di qualsiasi valutazione di una classe decorata, perché estende l'oggetto globale Reflect con le funzioni per i metadati. Lo importi all'inizio del file di ingresso.

Perché è importante

L'emissione dei tipi di progettazione consente ai framework di colmare il divario tra i tipi in fase di compilazione e il comportamento a runtime, elemento chiave per una DI e una validazione ergonomiche. Conoscerne i limiti, ovvero niente interfacce e niente generici, evita risultati Object sorprendenti.

Verifica rapida

Metta alla prova la propria comprensione di reflect-metadata.

Riepilogo

Con experimentalDecorators + emitDecoratorMetadata e un import "reflect-metadata" eseguito all'inizio, il compilatore emette design:type e design:paramtypes come costruttori a runtime. I framework li leggono per la DI e la validazione, anche se interfacce, unioni e generici diventano Object.

Domande Frequenti

La lezione «reflect-metadata e design type» è gratuita?

Sì — il testo completo di «reflect-metadata e design type» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso TypeScript Academy, passa a CoddyKit PRO. Il corso TypeScript Academy include 4 lezioni in totale.

Cosa imparerò in «reflect-metadata e design type»?

Acquisisca a runtime i tipi dei parametri e delle proprietà. Eserciti TypeScript Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare TypeScript Academy?

Non è richiesta alcuna esperienza precedente. TypeScript Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 3 di 4.

Quanto tempo richiede la lezione «reflect-metadata e design type»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione TypeScript Academy?

Sì. Ogni lezione TypeScript Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

← Torna a TypeScript Academy