Convertisseur JSON vers schéma Zod

Qu'est-ce qu'un schéma Zod ?

Exemples

{"id":101,"name":"Ada Lovelace","email":"ada@example.com","active":true,"roles":["admin","user"]}

import { z } from "zod";

export const RootSchema = z.object({
  id: z.number().int(),
  name: z.string(),
  email: z.string(),
  active: z.boolean(),
  roles: z.array(z.string()),
});

export type Root = z.infer<typeof RootSchema>;

{"repo":"zod","owner":{"login":"colinhacks","id":100}}

import { z } from "zod";

export const OwnerSchema = z.object({
  login: z.string(),
  id: z.number().int(),
});

export const RootSchema = z.object({
  repo: z.string(),
  owner: OwnerSchema,
});

export type Root = z.infer<typeof RootSchema>;

{"users":[{"id":1,"nick":"x"},{"id":2}]}

import { z } from "zod";

export const UserSchema = z.object({
  id: z.number().int(),
  nick: z.string().optional(),
});

export const RootSchema = z.object({
  users: z.array(UserSchema),
});

export type Root = z.infer<typeof RootSchema>;

{"items":[{"sku":"A1","discount":0.1},{"sku":"A2","discount":null}]}

import { z } from "zod";

export const ItemSchema = z.object({
  sku: z.string(),
  discount: z.number().nullable(),
});

export const RootSchema = z.object({
  items: z.array(ItemSchema),
});

export type Root = z.infer<typeof RootSchema>;

Comment convertir du JSON en Zod

1. 1

   Collez votre JSON

   Déposez un objet JSON, un tableau ou une réponse d'API dans le champ de saisie. La conversion démarre instantanément.

2. 2

   Ajustez la sortie

   Renommez le schéma racine et activez ou non la ligne import, le type z.infer ou le mot-clé export selon le style de votre projet.

3. 3

   Copiez ou téléchargez

   Récupérez le schéma Zod généré en un clic et collez-le directement dans votre couche de validation.

Common Use Cases

Valider les réponses d'API

Transformez un exemple de réponse REST ou GraphQL en schéma Zod et analysez-le à la frontière du fetch, pour que les données mal formées échouent tôt avec une erreur claire au lieu de se propager dans votre application.

Formulaires et saisies typés

Générez un schéma pour la saisie d'un formulaire ou d'une requête et réutilisez le type z.infer dans votre interface et vos gestionnaires pour une sûreté de typage de bout en bout.

Schémas tRPC et outils d'IA

Amorcez les schémas d'entrée et de sortie des procédures tRPC ou des outils d'IA à sortie structurée à partir d'une charge utile d'exemple au lieu de les écrire à la main.

Comment fonctionne la conversion

Inférence structurelle

Chaque objet devient un schéma nommé ; les formes identiques sont déclarées une seule fois puis réutilisées. Les tableaux d'objets fusionnent clé par clé, et les clés absentes de certains éléments deviennent .optional().

Correspondance de types correcte

Les entiers correspondent à z.number().int() et les décimaux à z.number(). Les chaînes, booléens et null correspondent à z.string(), z.boolean() et z.null() ; un tableau de primitifs mélangés devient un z.union().

Types TypeScript inclus

Un alias de type z.infer est émis pour le schéma racine, le schéma reste donc l'unique source de vérité et vos types ne divergent jamais de votre validation.

100 % côté navigateur

L'analyse et la génération s'exécutent dans votre navigateur sans aucun appel réseau, vos données restent donc privées.

Conseils pour des schémas Zod propres

Nommez votre schéma racine

Donnez un nom racine parlant, tel que User ou ApiResponse, au lieu du Root par défaut, pour un code lisible et auto-documenté.

Affinez z.unknown() et les unions

Les tableaux vides ou mixtes produisent z.unknown() ou un z.union() large. Collez un échantillon plus riche et représentatif pour que l'outil déduise des types précis, puis resserrez tout ce qui reste ambigu.

Validez à la frontière

Appelez safeParse() là où entrent des données non fiables — réponses d'API, saisies de formulaire, webhooks — pour intercepter les données incorrectes avant qu'elles n'atteignent la logique de votre application.

Questions fréquentes