JSON Schema zu Zod
Wandle ein JSON Schema in Zod-Schemas um. Typen, erforderliche Eigenschaften, Enums, const, anyOf, oneOf und allOf werden den Zod-Buildern zugeordnet. Gängige Validierungsschlüsselwörter wie minLength, maximum, pattern, format und minItems werden zu Zod-Prüfungen. Jede Definition wird zu einem exportierten Schema mit einem z.infer-Typ.
Häufig gestellte Fragen
Welche Validierungsschlüsselwörter werden umgewandelt?
minLength und maxLength werden bei Strings zu .min() und .max(), pattern wird zu .regex(), und die Formate email, uri, uuid und date-time werden zu .email(), .url(), .uuid() und .datetime(). minimum, maximum, exclusiveMinimum, exclusiveMaximum und multipleOf werden zu Zahlenprüfungen, minItems und maxItems zu Array-Prüfungen.
In welcher Reihenfolge werden Definitionen angeordnet?
Jede Definition wird vor den Schemas deklariert, die sie verwenden. Auf eine Definition, die direkt oder über andere auf sich selbst verweist, wird mit z.lazy verwiesen, damit der Code weiterhin ausgeführt werden kann.
Funktioniert die Typprüfung bei rekursiven Schemas?
Sie werden ausgeführt, aber TypeScript kann den Typ eines Schemas nicht ableiten, das über z.lazy auf sich selbst verweist. Füge für ein solches Schema eine explizite Typannotation hinzu, wie in der Zod-Dokumentation zu rekursiven Typen beschrieben.
Wie wird additionalProperties behandelt?
additionalProperties false fügt .strict() hinzu, ein Schema fügt .catchall() mit diesem Schema hinzu, true fügt .passthrough() hinzu, und ein Objekt ohne properties, aber mit einem additionalProperties-Schema, wird zu z.record(z.string(), ...).
Auf welche Zod-Version zielt der Code ab?
Die generierten Builder wie z.object, z.union, z.record mit einem Schlüssel-Schema und .nullable() gibt es in Zod 3 und Zod 4. Zod 4 unterstützt weiterhin String-Formatmethoden wie .email(), bietet aber auch z.email() als kürzere Schreibweise.
Was passiert mit Referenzen, die das Tool nicht auflösen kann?
Referenzen außerhalb des Dokuments, etwa auf eine andere Datei oder ein URL, werden zu z.unknown() und in einem Kommentar am Anfang der Ausgabe aufgeführt.