TypeScript Academy · Lektion

Decorator-Metadaten

Fügen Sie mit der Metadata API Metadaten hinzu und lesen Sie sie aus.

Decorator-Metadaten ist eine kostenlose TypeScript Academy-Lektion auf CoddyKit. Dies ist Lektion 2 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des TypeScript Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der TypeScript Academy-Kurs umfasst insgesamt 4 Lektionen.

Die Decorator-Metadaten-API

Standardisierte Dekoratoren enthalten einen integrierten Metadatenkanal. Das Kontextobjekt stellt ein metadata-Objekt bereit, in das Sie schreiben können. Die Klasse trägt diese Metadaten später unter dem bekannten Schlüssel Symbol.metadata.

context.metadata

Jeder Decorator-Kontext verwendet für die definierte Klasse dasselbe metadata-Objekt. Decorators fügen ihm Daten hinzu; daraus werden die Metadaten der Klasse.

function tag(label: string) {
  return function (value: any, context: DecoratorContext) {
    context.metadata[context.name] = label;
  };
}

Lesen über Symbol.metadata

Nach der Definition der Klasse sind die gesammelten Metadaten unter SomeClass[Symbol.metadata] verfügbar.

class User {
  @tag("identifier") id = 0;
  @tag("display")    name = "";
}

const meta = (User as any)[Symbol.metadata];
console.log(meta); // { id: "identifier", name: "display" }

Warum ein gemeinsames Objekt

Da alle Decorators einer Klasse in dasselbe metadata-Objekt schreiben, können Sie Informationen aus vielen Decorators in einem zusammenhängenden Datensatz sammeln, der die Klasse beschreibt.

Strukturierte Metadaten speichern

Metadatenwerte können beliebig strukturiert sein. Ein häufig verwendetes Muster ist ein verschachtelter Datensatz, dessen Schlüssel die Namen der Member sind.

function column(type: string) {
  return function (value: any, context: ClassFieldDecoratorContext) {
    const md = context.metadata as any;
    md.columns ??= {};
    md.columns[context.name] = { type };
  };
}

Metadaten auf Klassenebene

Ein Klassen-Decorator kann ebenfalls Metadaten schreiben, zum Beispiel einen Tabellennamen, der die spaltenbezogenen Informationen der einzelnen Felder ergänzt.

function entity(table: string) {
  return function (value: Function, context: ClassDecoratorContext) {
    (context.metadata as any).table = table;
  };
}

@entity("users")
class UserEntity {
  @column("serial") id = 0;
  @column("text")   name = "";
}

Vererbung von Metadaten

Metadatenobjekte sind entlang der Prototypenkette miteinander verknüpft: Das Metadatenobjekt einer Unterklasse hat die Metadaten des übergeordneten Objekts als Prototyp. Dadurch sind geerbte Einträge sichtbar, sofern sie nicht überschrieben werden.

Polyfill für Symbol.metadata

Symbol.metadata ist ein bekanntes Symbol. In Umgebungen, in denen es fehlt, weisen Sie einen Polyfill zu, damit die Laufzeitumgebung das gesammelte Objekt anhängen kann.

(Symbol as any).metadata ??= Symbol.for("Symbol.metadata");

Metadaten ohne reflect-metadata

Diese API ist selbst Bestandteil des Decorator-Vorschlags und erfordert daher nicht die separate Bibliothek reflect-metadata. Diese Bibliothek bleibt nur für die ältere experimentelle Emission von Design-Typen relevant (in der nächsten Lektion).

Ein praktischer Lese-Helfer

Ein kleiner Zugriffsfunktion kapselt das Lesen von Metadaten aus einer beliebigen Klasse und gibt ein leeres Objekt zurück, wenn keine Metadaten vorhanden sind.

function getMeta(cls: any): Record<string, any> {
  return (cls[Symbol.metadata] as Record<string, any>) ?? {};
}

Warum das wichtig ist

Metadaten machen aus Decorators, die nur einzelne Verhaltens-Wrapper bereitstellen, eine deklarative Beschreibung Ihrer Klassen. Frameworks lesen diese Beschreibung, um ORMs, Validatoren und Router ohne Laufzeit-Reflection-Hacks zu erstellen.

Kurzer Test

Überprüfen Sie Ihr Verständnis der Metadaten-API.

Zusammenfassung

Die Metadaten-API für Decorators stellt jedem Decorator ein gemeinsames context.metadata-Objekt bereit, das über Symbol.metadata an der Klasse verfügbar ist. Decorators sammeln strukturierte, vererbbare Metadaten ohne externe Bibliothek und ermöglichen deklarative, frameworkfreundliche Klassenbeschreibungen.

Häufig gestellte Fragen

Ist die Lektion „Decorator-Metadaten“ kostenlos?

Ja — der vollständige Text von „Decorator-Metadaten“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des TypeScript Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der TypeScript Academy-Kurs umfasst insgesamt 4 Lektionen.

Was lerne ich in „Decorator-Metadaten“?

Fügen Sie mit der Metadata API Metadaten hinzu und lesen Sie sie aus. Du übst TypeScript Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.

Brauche ich Erfahrung, um TypeScript Academy zu starten?

Keine Vorkenntnisse erforderlich. TypeScript Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 2 von 4.

Wie lange dauert die Lektion „Decorator-Metadaten“?

Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.

Kann ich in dieser TypeScript Academy-Lektion Code schreiben und ausführen?

Ja. Jede TypeScript Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.

Alle Lektionen in diesem Kurs

← Zurück zu TypeScript Academy