Beschreiben Sie die Form Ihrer Daten mit JSON Schema, verwandeln Sie mündliche Absprachen in ausführbare Validierung und lassen Sie es wiederum TypeScript-Typen und Formulargenerierung treiben.
7 ArtikelEs gibt viele Schlüsselwörter, aber nur ein Dutzend wird täglich verwendet. Bringen Sie type/properties/required/$ref richtig hin, behandeln Sie Fehlermeldungen gut, und Sie decken achtzig Prozent der realen Fälle ab.
Typen und Schemas decken je ein Segment ab: eines zur Kompilierzeit, eines zur Laufzeit. Die Frage ist nicht, welches man wählt, sondern wie man beide automatisch synchron hält.
Generierte Schemas blockieren oft gültige Daten. Erfahren Sie, warum reichere Beispiele schlechtere Schemas ergeben, und den Ablauf: Mehrfachdatensatz-Sampling, semantische Ergänzung, Fehlerlokalisierung.
$ref löst Wiederverwendung, allOf und oneOf lösen Komposition, und beides zu stapeln ist die Stelle, an der es bricht. Behandelt $id, $defs, Bedingungen, Rekursion, Bündelung und Debugging.
Ein Validator gibt Maschinenfehler aus; Nutzer wollen wissen, welches Eingabefeld falsch ist. Behandelt das Ajv-errors-Array, instancePath versus schemaPath, Gruppierung und Formulierung.
Eine bestandene Validierung bedeutet keine sauberen Daten. Pydantic ignoriert unbekannte Felder standardmäßig, Zod entfernt sie, Ajv lässt sie durch — erfundene Parameter und Tippfehler-Schlüssel rutschen lautlos durch. Dieser Artikel zeigt die drei Formen stiller Akzeptanz und liefert vollständige Rezepte: Objekte schließen, Typos-Konvertierung kontrollieren, jede Verschachtelungsebene festziehen.
Ein Schema hört beim Schreiben nicht auf — dort beginnt der Verfall. Ein Tippfehler lockert die Validierung still, ein Refactoring bricht alle Fixtures. Dieser Leitfaden zeigt eine praktikable Vertragstest-Architektur: positive, negative und Snapshot-Fixtures, Lint des Schemas selbst, einmalige kompilierte Wiederverwendung und vier CI-Tore, die einen Vertragsbruch in einen roten Build verwandeln.
