Ergebnis dieses Guides
Eine geprüfte Grenze für externe Daten
Arbeitsumgebung
TypeScript mit projektbezogener tsconfig und der vorgesehenen JavaScript-Laufzeit
Wann ist diese Entscheidung wichtig?
Typangaben beschreiben Erwartungen; externe Daten erfüllen diese nicht automatisch. Besonders an API- und Datenbankgrenzen ist eine Laufzeitprüfung nötig.
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.
Typen: Schritt für Schritt.
- 01
Vorbereiten
Definieren Sie gültige Felder, optionale Werte und zulässige Varianten. Unterscheiden Sie fehlend, leer und ausdrücklich null.
- 02
In TypeScript umsetzen
Prüfen Sie externe Daten vor der fachlichen Verarbeitung und formen Sie sie in ein internes Modell um.
- 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 gültiger Datensatz und ein Objekt mit falschem Feldtyp
- Erwartetes Ergebnis
- Nur geprüfte Werte gelangen in die fachliche Verarbeitung.
- Fehler- oder Grenzfall
- Eine Typumwandlung verdeckt keine fehlenden Felder oder unerwarteten Varianten.
TypeScript · begrenztes Beispiel
type Contact = { email: string };
function isContact(value: unknown): value is Contact {
return typeof value === 'object' && value !== null
&& 'email' in value && typeof value.email === 'string';
}Der Type Guard prüft hier nur die Form des Objekts. Zusätzliche Regeln für eine gültige E-Mail-Adresse bleiben notwendig. Eine Behauptung wie value as Contact würde die Laufzeitprüfung nicht ersetzen.
Abnahme und typische Fehler.
- Falsche Datenformen fallen früh und verständlich auf.
- Eine Typumwandlung verdeckt keine fehlenden Felder oder unerwarteten Varianten.
- Typen werden zur Laufzeit entfernt; externe Daten müssen trotzdem validiert werden.
Typischer Fehler
Eine Typannotation ersetzt keine Laufzeitvalidierung.
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.
