TypeScript Academy · Lektion

Typsichere Service-Tokens

Verwenden Sie typisierte Tokens, um Auflösungsfehler zur Laufzeit zu vermeiden.

Typsichere Service-Tokens ist eine kostenlose TypeScript Academy-Lektion auf CoddyKit. Dies ist Lektion 4 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.

Das Problem mit String-Token

String-Token wie "Logger" lassen sich leicht falsch schreiben und enthalten keine Typinformationen. Der Container kann nicht erkennen, dass get("Loggr") falsch ist, und der aufgelöste Typ ist häufig any.

Symbole als Token

Wenn Sie statt Strings Symbole verwenden, erhält jedes Token eine eindeutige Identität, die nicht versehentlich mit einer anderen kollidieren kann. Ein zentrales Register sorgt für Ordnung.

const TYPES = {
  Logger: Symbol.for("Logger"),
  Mailer: Symbol.for("Mailer"),
} as const;

Token Typen zuordnen

Das übergeordnete Ziel besteht darin, jedes Token mit dem Typ zu verknüpfen, zu dem es aufgelöst wird, damit der Container den richtigen Typ statt any zurückgibt. Dazu erstellen wir einen typisierten Token-Wrapper.

interface Token<T> {
  readonly id: symbol;
  readonly _type?: T; // phantom type marker
}

Typisierte Token erstellen

Ein Helper erzeugt ein Token, das seinen Typ in einem Phantomfeld speichert. Das Feld enthält niemals einen Wert, sondern überträgt lediglich Typinformationen an den Compiler.

function token<T>(name: string): Token<T> {
  return { id: Symbol.for(name) };
}
const LoggerToken = token<Logger>("Logger");

Eine typisierte Container-Schnittstelle

Wir typisieren den Container so, dass get den aufgelösten Typ aus dem Token ableitet. Keine Casts, kein any.

interface TypedContainer {
  get<T>(t: Token<T>): T;
  bind<T>(t: Token<T>, impl: () => T): void;
}

Binden mit abgeleiteten Typen

Beim Binden muss der Rückgabetyp der Factory mit dem Typ des Tokens übereinstimmen. Abweichungen werden zur Compile-Zeit erkannt.

declare const c: TypedContainer;
c.bind(LoggerToken, () => new ConsoleLogger());
// ConsoleLogger must satisfy Logger or this errors.

Auflösen mit vollständiger Typisierung

Jetzt gibt get genau den Typ des Tokens zurück. Autovervollständigung und Typprüfung funktionieren für das Ergebnis ohne manuelle Typannotation.

const logger = c.get(LoggerToken); // type: Logger
logger.log("typed resolution");

Fehler bei der Suche vermeiden

Da Token typisierte Werte sind, verweist ein Tippfehler auf eine nicht definierte Variable – ein Compile-Fehler statt eines stillschweigend falschen Strings. Die gesamte Klasse von Fehlern durch String-Schlüssel verschwindet.

// c.get(LogerToken) -> compile error: LogerToken is not defined

InversifyJS-Entsprechung

Inversify unterstützt ebenfalls Symbol-Token, und Community-Helper ergänzen typisierte Wrapper. Das Prinzip ist identisch: Binden Sie ein typisiertes Token an eine Implementierung und lösen Sie es mit dem richtigen Typ auf.

import { Container } from "inversify";
const TYPES = { Logger: Symbol.for("Logger") };
// container.bind<Logger>(TYPES.Logger).to(ConsoleLogger)

Ein Token-Register

Wenn Sie Token in einem einzigen Modul zentralisieren, gibt es eine zentrale Quelle der Wahrheit. Dadurch lassen sie sich in der gesamten Codebasis leicht finden, umstrukturieren und konsistent halten.

export const TOKENS = {
  Logger: token<Logger>("Logger"),
  Mailer: token<Mailer>("Mailer"),
};

Zusammenfassung der Vorteile

Typisierte Token bieten eine eindeutige Identität (Symbole), Sicherheit zur Compile-Zeit (Abweichungen werden abgelehnt), korrekte aufgelöste Typen (kein any) und Schutz vor Tippfehlern (Fehler durch nicht definierte Variablen).

Kurzer Test

Kurzer Test zu dieser Lektion.

Zusammenfassung

Typsichere Service-Token kapseln ein eindeutiges symbol mit einem Phantomtyp und ordnen jedes Token dem Typ zu, zu dem es aufgelöst wird. get gibt den präzisen Typ zurück, beim Binden werden passende Implementierungen erzwungen, und Tippfehler werden zu Compile-Fehlern statt zu stillen Fehlern bei der String-Suche.

Häufig gestellte Fragen

Ist die Lektion „Typsichere Service-Tokens“ kostenlos?

Ja — der vollständige Text von „Typsichere Service-Tokens“ 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 „Typsichere Service-Tokens“?

Verwenden Sie typisierte Tokens, um Auflösungsfehler zur Laufzeit zu vermeiden. 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 4 von 4.

Wie lange dauert die Lektion „Typsichere Service-Tokens“?

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