Ergebnis dieses Guides
Ein lesbares Beispiel mit Verzweigung
Arbeitsumgebung
TypeScript mit projektbezogener tsconfig und der vorgesehenen JavaScript-Laufzeit
Wann ist diese Entscheidung wichtig?
Syntax wird verständlicher, wenn einzelne Konstrukte eine Aufgabe lösen. Kürze ist dabei kein Ersatz für erkennbare Regeln und klare Namen.
Beschreiben Sie interne Verträge möglichst genau und halten Sie unbekannte externe Werte zunächst als unknown. Eine Typbehauptung prüft keine Netzwerkantwort. Die fertige Ausgabe läuft weiterhin unter den Regeln der gewählten JavaScript-Umgebung.
Syntax: Schritt für Schritt.
- 01
Vorbereiten
Wählen Sie einen Vergleich, eine Verzweigung und eine wiederholte Verarbeitung aus Ihrem Anwendungsfall.
- 02
In TypeScript umsetzen
Schreiben Sie den Ablauf zunächst ausdrücklich. Prüfen Sie danach, ob eine kürzere Form tatsächlich leichter verständlich ist.
- 03
Im tatsächlichen Projekt prüfen
Prüfen Sie sowohl die Typen mit dem Projektcompiler als auch das tatsächliche Laufzeitverhalten. Ein erfolgreicher Typcheck ersetzt keine Eingabeprüfung und keinen Berechtigungstest.
Beispiel zur Überprüfung
So lässt sich das Ergebnis prüfen.
Als Projektkontext dient eine Webanwendung mit mehreren Formularen und API-Antworten. Der folgende Prüffall ist eine Vorlage für diese Aufgabe und kein Bericht über eine Kundenmessung.
- Eingabe / Auslöser
- Ein Wert unterhalb, auf und oberhalb einer festgelegten Grenze
- Erwartetes Ergebnis
- Die Verzweigung behandelt alle drei Fälle nachvollziehbar.
- Fehler- oder Grenzfall
- Ein ungültiger Typ wird nicht stillschweigend in einen vermeintlich passenden Wert umgewandelt.
TypeScript · begrenztes Beispiel
type Result =
| { ok: true; value: number }
| { ok: false; error: string };
function label(result: Result): string {
return result.ok ? String(result.value) : result.error;
}Die unterscheidbaren Varianten erlauben einen klaren Erfolgs- und Fehlervertrag. Das Programm greift erst nach der Prüfung von ok auf die Eigenschaften der passenden Variante zu.
Abnahme und typische Fehler.
- Ein fremder Leser erkennt den Kontrollfluss ohne lange Erklärung.
- Ein ungültiger Typ wird nicht stillschweigend in einen vermeintlich passenden Wert umgewandelt.
- Typen werden zur Laufzeit entfernt; externe Daten müssen trotzdem validiert werden.
Typischer Fehler
Knappe Schreibweisen sind nicht automatisch besser.
Quellen und Versionshinweis
Die Anleitung beschreibt das Vorgehen; konkrete APIs, Produktfunktionen und Laufzeitgrenzen müssen zur eingesetzten Version passen. Halten Sie Version, Konfiguration und Prüfergebnis im Projekt fest und vergleichen Sie die verlinkte Dokumentation bei Änderungen.
