Sanyanggae LogoSanyanggae

📱 App-Entwicklung

Bedingte Typen und infer in TypeScript: Typumformung mit kleinen Beispielen

Bedingte Typen, Union-Verteilung und Template-Literale an Beispielen und ihre Abgrenzung zur Laufzeitprüfung.

사냥개 (Sanyanggae)Veröffentlicht Aktualisiert 9 Min. Lesezeit

Dieser Artikel ist eine Übersetzung des koreanischen Originals. Koreanisches Original · Übersetzungsprüfung: Prüfung durch KI

Bedingte Typen und infer in TypeScript: erklärendes Diagramm zu bedingten Typen, infer und Verteilung sowie Laufzeitprüfung
Erklärendes Diagramm von Sanyanggae · Bedingte Typen · infer und Verteilung · Laufzeitprüfung.

Wiederholen sich ähnliche Typdeklarationen in TypeScript, sucht man nach Wegen, einen Ergebnistyp aus einem Eingabetyp zu berechnen. Wichtiger als wenige Zeichen ist, ob die Beziehung der Typen für Leser klar bleibt. Dieser Artikel erklärt bedingte Typen und infer anhand eines fiktiven Versandbenachrichtigungsdienstes und trennt sie von der Prüfung tatsächlich korrekter externer Daten.

1. Bedingte Typen verzweigen mit einem Typ als Eingabe

Die offizielle Dokumentation zu bedingten Typen erläutert die Ergebnisauswahl anhand von extends. Das Beispiel erzeugt einen booleschen Literaltyp abhängig davon, ob der Typ ein String ist. Es ist keine Funktion, die zur Laufzeit Zeichenketten prüft.

type IsText<T> = T extends string ? true : false;
type NameIsText = IsText<'parcel'>; // true
type CountIsText = IsText<3>;       // false

Angenommen, die Benachrichtigungsfunktion erhält eine Zeichenkettenkennung, eine interne Funktion dagegen eine numerische. Vor bedingten Typen sollte man erklären können, warum beide getrennt sind. Bei anderer Bedeutung helfen eigene Namen; bei bloß anderer Schreibweise kann eine einheitliche Eingabe verständlicher sein. Verdecken Sie keine unklare Datenplanung mit Typtechniken.

Notieren Sie erwartete Eingaben und Ergebnisse paarweise. Kleine Beispiele für Strings, Zahlen, Unions und unerwartete Eingaben erleichtern komplexe Deklarationen. Prüfen Sie auch, ob Kommentar und vom Editor abgeleiteter Typ übereinstimmen. Ein natürlich wirkender Typname garantiert kein entsprechendes Rechenergebnis.

2. Union-Verteilung verändert die Bedeutung eines Arrays

Steht der Typparameter unmittelbar links der Bedingung, wird diese auf jedes Union-Mitglied verteilt. Soll die gesamte Union als Einheit gelten, vergleichen Sie die Form mit eckigen Klammern.

type SeparateLists<T> = T extends unknown ? T[] : never;
type Together<T> = [T] extends [unknown] ? T[] : never;
type A = SeparateLists<string | number>; // string[] | number[]
type B = Together<string | number>;      // (string | number)[]
const a: A = ['a', 'b'];
const b: B = ['a', 1];

Der erste Typ ist ein Array nur aus Strings oder eines nur aus Zahlen. Der zweite erlaubt beide in einem Array. Ob die ganze Versandliste nur eine Codeart oder jedes Element andere Arten zulassen soll, bestimmt das passende Ergebnis. Beide haben sichtbare Klammern, aber nicht denselben Vertrag.

Bei Problemen testen Sie einzelne Mitglieder statt sofort den ganzen komplexen Hilfstyp zu lesen. Vergleichen Sie String, Zahl und deren Union. Sobald die beabsichtigte Verteilung klar ist, lässt sich die zusätzliche Klammer begründen. Halten Sie neben Endergebnissen auch Beispiele erlaubter Werte fest.

3. infer benennt und entnimmt einen Typ aus einer Struktur

infer benennt einen Teil der in einem bedingten Typ abgeglichenen Struktur. Dieses kleine Beispiel entfernt eine Promise-Ebene.

type OneResult<T> = T extends Promise<infer Value> ? Value : T;
type Parcel = OneResult<Promise<{ tracking: string }>>;
type ParcelList = OneResult<Promise<string[]>>;

Der Code startet keine asynchrone Arbeit und wartet nicht. Er beschreibt nur die Ergebnisform beim Kompilieren. Ein Name wie Resolved könnte einen schon eingetroffenen Wert suggerieren; beachten Sie den Verwendungskontext. Laufzeitwarten bleibt Aufgabe asynchronen Codes.

Wenn ein rekursiv erwarteter Ergebnistyp nötig ist, prüfen Sie den Standardhilfstyp Awaited, bevor Sie das einstufige Beispiel erweitern. Einfachheit für Unterricht und Anforderungen gemeinsamer Werkzeuge unterscheiden sich. Dokumentieren Sie bei neuen Teamhilfstypen Eingaben mit anderem Ergebnis als beim Standard sowie den Grund dafür.

4. Ereignisnamen mit Template-Literalen verbinden

Template-Literal-Typen stellen Kombinationen von Stringliteralen als Typ dar. Im Versanddienst lassen sich Bereich und Aktion zu Ereignisnamen verbinden.

type Scope = 'parcel' | 'address';
type Action = 'created' | 'updated';
type EventName = `${Scope}:${Action}`;
const event: EventName = 'parcel:created';

Tippfehler können beim Kompilieren auffallen, doch die Gültigkeit aller Kombinationen im realen Dienst ist eine andere Frage. Wird etwa nur das Löschen einer Adresse unterstützt, bildet das einfache Produkt von Bereich und Aktion die Regel womöglich falsch ab. Erwägen Sie zuerst eine ausdrückliche Zuordnung erlaubter Ereignisse und ihrer Payloads.

Mit mehr Ereignissen zählt, ob Leser die echten Namen leicht finden. Statt mehrstufiger Kombinationsregeln können Namen für externe Systeme in einer Datei sichtbar sein. Vergleichen Sie vor und nach Abstraktion, wie neue Teammitglieder falsche Ereignisse entdecken. Typraffinesse und Nutzbarkeit werden gemeinsam bewertet.

5. Externes JSON muss zur Laufzeit geprüft werden

Der Typname User oder Parcel an einer API-Antwort garantiert nicht deren wirkliche Struktur. Betrachten Sie eine einfache Prüfung benötigter Felder nach Empfang als unknown.

function hasTracking(value: unknown): value is { tracking: string } {
  return typeof value === 'object' && value !== null
    && 'tracking' in value && typeof value.tracking === 'string';
}
const incoming: unknown = { tracking: 'DEMO-001' };
if (hasTracking(incoming)) console.log(incoming.tracking);

Die Prüfung bestätigt nur einen String im tracking-Feld. Sie bestätigt weder die Existenz der Sendungsnummer noch die Zugriffsberechtigung des Nutzers. Typverengung, Geschäftsregeln und Rechteprüfung sind getrennte Aufgaben. Die offizielle Narrowing-Dokumentation erklärt Verengung durch Bedingungen.

6. Ein kleiner Prüfablauf für Typwerkzeuge

Notieren Sie zuerst zwei reale erlaubte und zwei abzulehnende Werte. Beschreiben Sie die Bedeutung mit gewöhnlicher Union und ausdrücklichen Objekten. Bleiben wiederkehrende Beziehungen, begründen bedingte Typen oder infer den Einsatz. Wenn Lesedauer stark steigt, extrahieren Sie nur Gemeinsamkeiten und belassen anderes bei gewöhnlichen Typen.

Führen Sie Typ- und Laufzeitprüfung getrennt aus. Compilerablehnung falscher Ereignisnamen und verständliche Programmfehler bei fehlenden Serverfeldern ergänzen sich. Erst kleine Beispiele prüfen und dann mit echten Eingabegrenzen verbinden macht Typumformung für sichere Anwendungsplanung nützlich.

Quellen und weiterführende Literatur

Dieser Artikel erläutert Informationen aus öffentlichen Quellen. Die Nennung einer Einrichtung bedeutet weder deren Prüfung noch deren Zustimmung.

Herausgeber und Kontakt

Weitere Artikel zum Thema