Decorator e metadati
Abilitare i decorator sperimentali, scrivere decorator per classi, metodi e proprietà e usare reflect-metadata per gli schemi di dependency injection
Decorator e metadati è una lezione Frontend Academy gratuita su CoddyKit. Questa è la lezione 2 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 Frontend Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Frontend Academy include 4 lezioni in totale.
Che cosa sono i decorator?
I decorator sono funzioni che modificano classi, metodi, proprietà o parametri al momento della definizione. Sono ampiamente utilizzati in Angular, NestJS, TypeORM e MobX basato su classi.
Sintassi dei decorator
Anteponi a una classe, a un metodo, a una proprietà o a un parametro @DecoratorName. La funzione decorator viene eseguita quando la classe viene definita.
@Component({ selector: 'app-root' })
export class AppComponent {
@Input() title: string;
@HostListener('click')
onClick() {
console.log('clicked');
}
}Abilitare i decorator
Abiliti il flag sperimentale in tsconfig.json. I nuovi decorator ECMAScript Stage 3 (TypeScript 5.0+) non richiedono questo flag, ma hanno una semantica diversa.
{
"compilerOptions": {
"experimentalDecorators": true,
"emitDecoratorMetadata": true
}
}Class decorator
Riceve il costruttore come argomento. Può sostituire, avvolgere o estendere la classe.
function Singleton<T extends { new (...a: any[]): {} }>(target: T) {
let instance: T;
return class extends target {
constructor(...args: any[]) {
if (!instance) instance = new target(...args) as T;
return instance;
}
};
}
@Singleton
class Logger { /* ... */ }Method decorator
Riceve (target, key, descriptor). Può avvolgere il metodo, ad esempio per registrare le chiamate.
function Log(target: any, key: string, descriptor: PropertyDescriptor) {
const original = descriptor.value;
descriptor.value = function (...args: any[]) {
console.log(`[${key}]`, args);
return original.apply(this, args);
};
}
class Service {
@Log
greet(name: string) { return `Hello ${name}`; }
}Property decorator
Riceve (target, key). Viene spesso utilizzato con reflect-metadata per registrare informazioni sulla proprietà.
function Required(target: any, key: string) {
const existing = Reflect.getMetadata('required', target) || [];
Reflect.defineMetadata('required', [...existing, key], target);
}
class User {
@Required name: string;
@Required email: string;
}Parameter decorator
Riceve (target, key, parameterIndex). Viene utilizzato per l'iniezione delle dipendenze, registrando quali parametri richiedono quali servizi.
function Inject(token: string) {
return function (target: any, key: string, index: number) {
const existing = Reflect.getMetadata('inject', target, key) || {};
existing[index] = token;
Reflect.defineMetadata('inject', existing, target, key);
};
}
class UserService {
constructor(@Inject('Database') db: Database) {}
}reflect-metadata
reflect-metadata è un polyfill che consente ai decorator di leggere e scrivere metadati sulle classi. È necessario per la DI di Angular e per molti ORM.
npm install reflect-metadata
// main.ts (entry point):
import 'reflect-metadata';
import { Reflect } from 'reflect-metadata';
Reflect.defineMetadata('key', 'value', target);
Reflect.getMetadata('key', target); // 'value'Factory di decorator
Una factory restituisce un decorator e viene utilizzata per passare argomenti.
function Component(config: { selector: string }) {
return function (target: any) {
target.selector = config.selector;
};
}
@Component({ selector: 'app-root' })
class AppComponent {}Caso d'uso: convalida
Combini i property decorator con una funzione validate() per creare una piccola libreria di convalida.
// Decorator records that a field is required:
function Required(target: any, key: string) {
const fields = Reflect.getMetadata('required', target) || [];
Reflect.defineMetadata('required', [...fields, key], target);
}
class User {
@Required name!: string;
@Required email!: string;
}
function validate(obj: any): string[] {
const required: string[] = Reflect.getMetadata('required', obj) || [];
return required.filter(k => obj[k] == null);
}Decorator Stage 3 (TC39)
I decorator standardizzati (TS 5.0+, supportati in Node 22+ dietro un flag) hanno una firma diversa. Non richiedono il flag sperimentale né reflect-metadata.
Quando usare i decorator
Utilizzi i decorator quando il framework li mette a disposizione (Angular, NestJS, TypeORM). Non li crei autonomamente nel normale codice frontend: aggiungono complessità e la legano a uno specifico comportamento del runtime.
Verifica rapida
Quali flag di tsconfig è necessario abilitare per usare i decorator legacy (sperimentali) con la reflection dei metadati?
Riepilogo: decorator
I decorator modificano classi, metodi, proprietà e parametri al momento della definizione. Abiliti experimentalDecorators + emitDecoratorMetadata. Le firme dei decorator per classi, metodi, proprietà e parametri sono diverse. reflect-metadata memorizza i metadati; le factory consentono di passare argomenti. Sono ampiamente utilizzati da Angular, NestJS e TypeORM. I decorator Stage 3 (TS 5+) rappresentano il futuro e non richiedono flag.
Domande Frequenti
La lezione «Decorator e metadati» è gratuita?
Sì — il testo completo di «Decorator e metadati» è 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 Frontend Academy, passa a CoddyKit PRO. Il corso Frontend Academy include 4 lezioni in totale.
Cosa imparerò in «Decorator e metadati»?
Abilitare i decorator sperimentali, scrivere decorator per classi, metodi e proprietà e usare reflect-metadata per gli schemi di dependency injection Eserciti Frontend 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 Frontend Academy?
Non è richiesta alcuna esperienza precedente. Frontend 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 2 di 4.
Quanto tempo richiede la lezione «Decorator e metadati»?
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 Frontend Academy?
Sì. Ogni lezione Frontend 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
- Tipi di literal template
- Decorator e metadati
- TypeScript con React: generics, hook e FC
- Strict Mode ed eliminazione di any