Vollständige Fehlerbehandlung mit diskriminierten Unions
Schreiben Sie vollständige Handler für diskriminierte Unions mit switch+never, Hilfsfunktionen und Prüfungen der Abdeckung zur Compile-Zeit über mehrere Module hinweg.
Vollständige Fehlerbehandlung mit diskriminierten Unions ist eine kostenlose TypeScript Academy-Lektion auf CoddyKit. Dies ist Lektion 2 von 2. 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 2 Lektionen.
Einführung
Ziel: Stellen Sie sicher, dass jedes Mitglied einer Union behandelt wird. Sie verwenden switch + never, eine kleine exhaustiveCheck-Utility und sehen, wie Sie die Abdeckung über mehrere Dateien hinweg erhalten.
- Diskriminatoren (Tag-Felder)
- Vollständige switch-Anweisungen
- Fehlschlagen mit Standardzweigen
Diskriminierte Union
Eine diskriminierte Union besitzt ein gemeinsames Tag (hier kind). Jede Variante enthält ihre eigenen Daten.
export type Payment =
| { kind: "Card"; last4: string }
| { kind: "Cash" }
| { kind: "Wire"; iban: string }Switch und never
Im default-Zweig wird p never zugewiesen. Wenn Sie später eine neue Variante hinzufügen, meldet der Compiler einen Fehler, bis Sie sie behandeln.
export function describe(p: Payment): string {
switch (p.kind) {
case "Card": return `Card ••••${p.last4}`
case "Cash": return "Cash"
case "Wire": return `Wire ${p.iban}`
default: {
const _exhaustive: never = p
return _exhaustive
}
}
}exhaustiveCheck-Helper
Verwenden Sie einen kleinen Helper, um die Absicht deutlich zu machen. Der never-Parameter macht unbehandelte Fälle zu einem Typfehler und nicht nur zu einer Laufzeitausnahme.
export function exhaustiveCheck(x: never): never {
throw new Error(`Unhandled case: ${JSON.stringify(x)}`)
}
export function pay(p: Payment): string {
switch (p.kind) {
case "Card": return "charged card"
case "Cash": return "took cash"
case "Wire": return "initiated wire"
default: return exhaustiveCheck(p)
}
}Abdeckung über Module hinweg
Wenn Unions in einer Datei definiert und in einer anderen behandelt werden, führt ein hinzugefügter Zweig weiterhin zu fehlschlagenden Builds, bis alle switch-Anweisungen aktualisiert sind – genau das ist beabsichtigt.
// errors.ts
export type AppError =
| { tag: "Auth"; reason: "Unauthorized" | "Forbidden" }
| { tag: "NotFound"; resource: string }
| { tag: "Conflict"; resource: string }
// handler.ts
import type { AppError } from "./errors"
import { exhaustiveCheck } from "./exhaustive"
export function toStatus(e: AppError): number {
switch (e.tag) {
case "Auth": return e.reason === "Unauthorized" ? 401 : 403
case "NotFound": return 404
case "Conflict": return 409
default: return exhaustiveCheck(e)
}
}Tipps und Fallstricke
Tipps:
- Bevorzugen Sie String-Literal-Tags (z. B.
tag/kind). - Halten Sie Varianten klein; komponieren Sie Daten über verschachtelte Objekte statt über riesige Unions.
- Verwenden Sie niemals
defaultohne einennever-Guard; dadurch werden fehlende Fälle verborgen.
Prüfung auf Vollständigkeit
Schnellprüfung: Was erzwingt eine vollständige Behandlung?
Zusammenfassung
Zusammenfassung: Verwenden Sie einen Diskriminator, schreiben Sie einen switch und weisen Sie im default-Zweig never zu (oder rufen Sie exhaustiveCheck auf), um bei der Weiterentwicklung von Unions eine vollständige Abdeckung zu garantieren.
Häufig gestellte Fragen
Ist die Lektion „Vollständige Fehlerbehandlung mit diskriminierten Unions“ kostenlos?
Ja — der vollständige Text von „Vollständige Fehlerbehandlung mit diskriminierten Unions“ 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 2 Lektionen.
Was lerne ich in „Vollständige Fehlerbehandlung mit diskriminierten Unions“?
Schreiben Sie vollständige Handler für diskriminierte Unions mit switch+never, Hilfsfunktionen und Prüfungen der Abdeckung zur Compile-Zeit über mehrere Module hinweg. 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 2.
Wie lange dauert die Lektion „Vollständige Fehlerbehandlung mit diskriminierten Unions“?
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
- Result-/Either-ähnliche Typen
- Vollständige Fehlerbehandlung mit diskriminierten Unions