JSON zu Zod Konverter — Schemas generieren

Zod-Schemas, erzeugt aus JSON

TypeScript-Typen verschwinden zur Laufzeit, daher sind Daten aus einer API, einem Formular oder localStorage nur so sicher wie der Code, der sie prüft. Zod schließt diese Lücke, indem es Werte gegen ein Schema validiert und den TypeScript-Typ aus demselben Schema ableitet. Dieser JSON-zu-Zod-Konverter schreibt das Schema für Sie: Fügen Sie ein JSON-Beispiel ein, und jedes Objekt wird zu einem z.object, Primitive werden zu z.string(), z.number() und z.boolean(), Arrays zu z.array(...), und verschachtelte Objekte erhalten eigene benannte Schemas, die überall wiederverwendet werden, wo sie vorkommen.

Das Tool basiert auf quicktype, das alle Elemente jedes Arrays zusammenführt, bevor es Typen ableitet. Felder, die nur in einigen Einträgen vorkommen, werden als optional markiert, und Werte, die manchmal null sind, als nullable – das Schema akzeptiert also die echten Daten, die Sie gesehen haben, und nicht nur das erste Element.

Schemas und abgeleitete Typen zusammen

Standardmäßig exportiert die Ausgabe zu jedem Schema auch einen TypeScript-Typ per z.infer und liefert so eine einzige Quelle der Wahrheit für Validierung und statische Typisierung. Importieren Sie das Root-Schema und rufen Sie RootSchema.parse(data) auf, um einen nicht vertrauenswürdigen Wert zu validieren und ein typisiertes Ergebnis zu erhalten, oder safeParse, wenn Sie Fehler ohne Exceptions behandeln möchten. Aktivieren Sie Schemas only, wenn Sie Typen lieber anderswo deklarieren. Das ist eine natürliche Ergänzung zum Tool JSON zu TypeScript, wenn Sie Laufzeitgarantien statt nur Hinweise zur Kompilierzeit benötigen.

Tipps für strengere Schemas

Erzeugen Sie das Schema aus einem repräsentativen Beispiel mit mehreren Array-Elementen und ausgefüllten optionalen Feldern. Verfeinern Sie dann, was ein Beispiel nicht zeigen kann: Ergänzen Sie .email(), .url() oder .uuid() bei String-Feldern, nutzen Sie z.enum für Felder mit festem Wertevorrat, beschränken Sie Zahlen mit .int() oder .min() und entscheiden Sie, ob unbekannte Schlüssel entfernt oder mit .strict() abgelehnt werden sollen. Die gesamte Erzeugung läuft lokal, daher können Sie bedenkenlos Produktiv-Payloads einfügen.