Générateur de schéma Zod à partir de JSON

Zod est une bibliothèque de validation de schéma en TypeScript qui vous permet de définir des formes de données et de les valider à l'exécution. Contrairement aux types TypeScript qui n'existent que lors de la compilation et sont effacés en production, les schémas Zod valident les données réelles circulant dans votre application. Cela détecte les réponses API mal formées, les entrées de formulaire invalides et les formes de données inattendues avant qu'elles ne causent des bogues. Zod s'intègre bien avec React Hook Form, tRPC et les actions serveur Next.js, ce qui en fait la bibliothèque de validation à l'exécution la plus populaire de l'écosystème TypeScript.

L'outil utilise des expressions régulières pour correspondre aux motifs de chaîne courants dans vos valeurs JSON. Les chaînes de date/heure ISO 8601 comme 2024-01-15T10:30:00Z sont détectées et mappées à z.string().datetime(). Les chaînes UUID v4 sont mappées à z.string().uuid(). Les adresses e-mail reçoivent z.string().email(), les URL reçoivent z.string().url() et les adresses IP reçoivent z.string().ip(). Cela signifie que votre schéma généré inclut la validation intégrée de ces formats courants plutôt que simplement z.string(), ce qui vous donne une sécurité de type plus précise et une validation prête à l'emploi.

En mode strict, le schéma généré utilise z.object().strict(), ce qui signifie que toutes les propriétés non définies dans le schéma entraîneront l'échec de la validation. Ceci est utile lorsque vous souhaitez vous assurer qu'aucune donnée supplémentaire ne s'infiltre. Le mode passthrough utilise z.object().passthrough(), ce qui permet aux propriétés inconnues de passer sans validation. Utilisez le mode strict pour les données sensibles à la sécurité comme les entrées d'API. Utilisez le mode passthrough lorsque vous vous souciez uniquement de champs spécifiques et que vous voulez ignorer le reste, comme lorsque vous consommez une API tierce qui peut ajouter de nouveaux champs.

Lorsque votre JSON contient un tableau d'objets, l'outil compare tous les objets du tableau pour déterminer quels champs sont présents dans chaque élément par rapport à seulement certains éléments. Les champs qui apparaissent dans tous les objets deviennent obligatoires dans le schéma. Les champs qui manquent dans au moins un objet sont marqués avec .optional(). Ceci est particulièrement utile lorsque vous travaillez avec des réponses API réelles où certains enregistrements ont des champs nuls ou manquants. L'outil fusionne intelligemment toutes les formes d'objet pour que vous obteniez un schéma complet qui gère toutes les variations de vos données.