Convertir JSON en Zod — Générateur de schémas

Des schémas Zod générés à partir de JSON

Les types TypeScript disparaissent à l'exécution : les données issues d'une API, d'un formulaire ou de localStorage ne sont donc sûres que dans la mesure où le code qui les vérifie l'est. Zod comble ce manque en validant les valeurs par rapport à un schéma et en inférant le type TypeScript à partir de ce même schéma. Ce convertisseur JSON vers Zod écrit le schéma pour vous : collez un exemple de JSON et chaque objet devient un z.object, les primitives correspondent à z.string(), z.number() et z.boolean(), les tableaux deviennent z.array(...), et les objets imbriqués reçoivent leurs propres schémas nommés, réutilisés partout où ils apparaissent.

L'outil s'appuie sur quicktype, qui fusionne chaque élément de chaque tableau avant d'inférer les types. Les champs présents dans certains éléments seulement sont marqués optionnels, et les valeurs parfois null sont marquées nullables : le schéma accepte donc les vraies données observées, et pas seulement leur premier élément.

Schémas et types inférés ensemble

Par défaut, la sortie exporte aussi un type TypeScript pour chaque schéma via z.infer, ce qui donne une source unique de vérité pour la validation et le typage statique. Importez le schéma racine et appelez RootSchema.parse(data) pour valider une valeur non fiable et obtenir un résultat typé, ou safeParse pour gérer les erreurs sans exceptions. Cochez Schemas only si vous préférez déclarer les types ailleurs. C'est le complément naturel de l'outil JSON vers TypeScript lorsque vous avez besoin de garanties à l'exécution, et pas seulement d'indications à la compilation.

Conseils pour des schémas plus stricts

Générez à partir d'un exemple représentatif comportant plusieurs éléments de tableau et des champs optionnels renseignés. Affinez ensuite ce qu'un exemple ne peut pas montrer : ajoutez .email(), .url() ou .uuid() aux champs de type chaîne, utilisez z.enum pour les champs à ensemble de valeurs fixe, contraignez les nombres avec .int() ou .min(), et décidez si les clés inconnues doivent être supprimées ou rejetées avec .strict(). Toute la génération s'effectue en local : vous pouvez donc coller sans risque des charges utiles de production.