JSON vers Zod

Transformez un échantillon JSON en Zod Schema TypeScript. Génération locale, pour partager les mêmes règles entre validation front et Structured Output.

Si le front valide déjà formulaires ou API avec Zod, inutile de réécrire z.object. Collez l'échantillon : z.string / z.number / z.array.

La sortie porte souvent z.infer, utilisable comme type. Si le dépôt bascule entre Zod 3 et 4, ajustez après génération.

Conversion dans le navigateur : pas besoin d'envoyer l'échantillon à un site de codegen.

La différence avec une interface écrite à la main

Une interface n'est que du type : au runtime, une mauvaise donnée passe. Zod parse et dit quel champ pose problème.

Corrections fréquentes après génération

Optionnel → .optional(), nullable → .nullable(), énum → z.enum, dates → refine. Ne laissez pas toutes les clés required.

Comment faire

Collez un échantillon JSON, de préférence une vraie réponse d'API.
Cliquez « Générer Zod », copiez le TypeScript à droite.
Selon le métier, passez certains champs en optional / nullable / enum.
Utilisez z.infer comme type, ou exportez pour le confronter à Structured Output.
Une fois branché au front, lancez safeParse sur une deuxième réponse.

Cas d'usage

Ajouter une validation runtime aux réponses API d'un projet Next.js / React.
Partager la même liste de champs avec Structured Output, sans deux jeux de règles.
Partir de Zod depuis l'échantillon, puis superRefine pour les contraintes croisées.
Zod comme doc : un nouveau collègue voit la forme de l'objet dans le schema.

À garder en tête

Inférence optimiste : les clés vues dans l'échantillon deviennent facilement required.
Unions, structures récursives et branded types : à la main.
Ça n'remplace pas la validation serveur : ça épaissit seulement le filet côté front.

FAQ

Est-ce de l'écriture Zod 3 ?

La sortie est une structure z.object / z.array / z.string courante ; ajustez selon la version Zod du projet.

Génère-t-on des types TypeScript ?

Oui, avec z.infer, utilisable directement comme type, sans interface à la main.

Les objets imbriqués sont-ils pris en charge ?

Imbrications et tableaux courants. Trop profond ou récursif : découpez les types à la main.

Le JSON est-il envoyé ?

Non, la conversion se fait dans le navigateur.

Génère-t-on des messages d'erreur ?

Pas de textes métier par défaut. Pour des erreurs en français, ajoutez message sur .min / .email.

Quelle différence avec Vers le code ?

Vers le code sort interface / struct ; ici un schema Zod exécutable.

Comment distinguer optional et nullable ?

Clé absente : optional ; clé présente, valeur null : nullable. L'échantillon ne le dit pas : à vous de décider.

Peut-on l'utiliser côté serveur ?

Le même schema peut tourner en Node. Validez encore à la passerelle ou au backend.