Конвертер JSON в схему Zod

Что такое схема Zod?

Примеры

{"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>;

Как конвертировать JSON в Zod

1. 1

   Вставьте JSON

   Поместите объект JSON, массив или ответ API в поле ввода. Конвертация начинается мгновенно.

2. 2

   Настройте вывод

   Переименуйте корневую схему и переключайте строку импорта, тип z.infer или ключевое слово export, чтобы соответствовать стилю вашего проекта.

3. 3

   Скопируйте или скачайте

   Получите сгенерированную схему Zod одним кликом и вставьте её прямо в свой слой валидации.

Common Use Cases

Валидация ответов API

Превратите образец ответа REST или GraphQL в схему Zod и разбирайте её на границе запроса, чтобы некорректные данные быстро падали с понятной ошибкой, а не просачивались через приложение.

Типобезопасные формы и ввод

Сгенерируйте схему для ввода формы или запроса и переиспользуйте тип z.infer в интерфейсе и обработчиках для сквозной типобезопасности.

Схемы tRPC и инструментов AI

Инициализируйте схемы ввода и вывода для процедур tRPC или инструментов AI со структурированным выводом из примера payload, вместо того чтобы писать их вручную.

Как работает конвертация

Структурный вывод

Каждый объект становится именованной схемой; одинаковые формы объявляются один раз и переиспользуются. Массивы объектов сливаются ключ за ключом, а ключи, отсутствующие в части элементов, становятся .optional().

Правильное сопоставление типов

Целые числа отображаются на z.number().int(), а десятичные на z.number(). Строки, логические значения и null отображаются на z.string(), z.boolean() и z.null(); массив смешанных простых типов становится z.union().

Типы TypeScript в комплекте

Псевдоним типа z.infer выдаётся для корневой схемы, поэтому схема остаётся единственным источником истины, а ваши типы никогда не расходятся с валидацией.

100% на стороне клиента

Разбор и генерация выполняются в браузере без сетевых запросов, поэтому ваши данные остаются приватными.

Советы для чистых схем Zod

Дайте имя корневой схеме

Задайте осмысленное корневое имя, например User или ApiResponse, вместо стандартного Root для читаемого, самодокументируемого кода.

Уточняйте z.unknown() и объединения

Пустые или смешанные массивы дают z.unknown() или широкое z.union(). Вставьте более богатый, представительный образец, чтобы инструмент вывел точные типы, затем ужесточите всё, что остаётся неоднозначным.

Валидируйте на границе

Вызывайте safeParse() там, где входят недоверенные данные — ответы API, ввод форм, вебхуки — чтобы плохие данные были перехвачены до того, как достигнут логики приложения.

Часто задаваемые вопросы