JSON Schema naar Zod
Zet een JSON Schema om in Zod-schema's. Types, verplichte eigenschappen, enums, const, anyOf, oneOf en allOf worden omgezet naar builders van Zod, en gangbare validatietrefwoorden zoals minLength, maximum, pattern, format en minItems worden Zod-controles. Elke definitie wordt een geëxporteerd schema met een z.infer-type.
Veelgestelde vragen
Welke validatietrefwoorden worden omgezet?
minLength en maxLength worden .min() en .max() voor strings, pattern wordt .regex(), en de formats email, uri, uuid en date-time worden .email(), .url(), .uuid() en .datetime(). minimum, maximum, exclusiveMinimum, exclusiveMaximum en multipleOf worden getalcontroles, en minItems en maxItems worden arraycontroles.
Hoe worden definities geordend?
Elke definitie wordt gedeclareerd voordat de schema's die deze gebruiken worden gedeclareerd. Naar een definitie die direct of via andere definities naar zichzelf verwijst, wordt verwezen met z.lazy, zodat de code blijft werken.
Worden recursieve schema's getypeerd gecontroleerd?
Ze werken, maar TypeScript kan het type niet afleiden van een schema dat via z.lazy naar zichzelf verwijst. Voeg aan zo'n schema een expliciete typeannotatie toe, zoals beschreven in de documentatie van Zod voor recursieve typen.
Hoe wordt additionalProperties afgehandeld?
additionalProperties false voegt .strict() toe, een schema voegt .catchall() met dat schema toe, true voegt .passthrough() toe, en een object zonder properties maar met een additionalProperties-schema wordt z.record(z.string(), ...).
Op welke versie van Zod richt de code zich?
De gegenereerde builders, zoals z.object, z.union, z.record met een sleutelschema en .nullable(), bestaan in Zod 3 en Zod 4. Zod 4 ondersteunt nog steeds de stringformatmethoden zoals .email(), maar biedt ook z.email() als kortere vorm.
Wat gebeurt er met verwijzingen die de tool niet kan oplossen?
Verwijzingen buiten het document, zoals naar een ander bestand of een URL, worden z.unknown() en vermeld in een commentaar bovenaan de uitvoer.