Реклама мешает? Идти Без рекламы Сегодня 

Генератор JSON в Zod Schema

РазработчикМатематика

Реклама · УДАЛИТЬ?

ВХОД

Автоматический процесс

ВЫХОД

Клиентская сторона

Реклама · УДАЛИТЬ?

Гид

Генератор JSON в Zod Schema

Преобразуйте любые данные JSON в готовую к использованию схему валидации Zod. Вставьте ваш JSON и получите правильно типизированный код Zod с рекурсивным выводом типов, обнаружением шаблонов строк для дат, UUID, адресов электронной почты и URL-адресов, автоматическим обнаружением перечислений для полей с ограниченным количеством уникальных значений и обработкой необязательных полей при обработке массивов объектов.

Как использовать

Вставьте ваш JSON в область ввода или нажмите кнопку примера, чтобы загрузить пример данных. Инструмент мгновенно создает соответствующую схему Zod. Переключайтесь между выводом TypeScript и обычным JavaScript. Включите строгий режим для точных форм объектов или режим passthrough для разрешения неизвестных ключей. При необходимости добавьте строку экспорта вывода типа. Настройте имя переменной схемы и скопируйте вывод в буфер обмена.

Возможности

Рекурсивное определение типов – Обрабатывает вложенные объекты, массивы, смешанные типы с z.union() и все примитивные типы
Обнаружение шаблонов строк – Автоматически обнаруживает ISO-даты, UUID, адреса электронной почты, URL-адреса и IP-адреса и применяет соответствующие валидаторы Zod
Обнаружение перечислений – Когда строковое поле имеет менее 6 уникальных значений среди элементов массива, предлагается z.enum() вместо z.string()
Обнаружение необязательных полей – Поля, отсутствующие во всех элементах массива, автоматически помечаются как .optional()
Строгий режим против Passthrough – Переключайтесь между .strict() для точных форм или .passthrough() для разрешения неизвестных ключей
Выходные данные TypeScript – Переключайтесь между TypeScript и обычным JavaScript с дополнительным экспортом типа z.infer
Генерация в реальном времени – Схема мгновенно обновляется по мере ввода или вставки JSON
Копировать в буфер обмена – Копирование сгенерированного кода схемы в один клик

Реклама · УДАЛИТЬ?

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

Что такое Zod и зачем его использовать?

Zod — это библиотека валидации схем с приоритетом TypeScript, которая позволяет определять структуры данных и проверять их во время выполнения. В отличие от типов TypeScript, которые существуют только во время компиляции и удаляются в производстве, схемы Zod проверяют фактические данные, проходящие через ваше приложение. Это позволяет выявлять искаженные ответы API, неверные входные данные форм и неожиданные структуры данных до того, как они вызовут ошибки. Zod хорошо интегрируется с React Hook Form, tRPC и серверными действиями Next.js, что делает его самой популярной библиотекой валидации во время выполнения в экосистеме TypeScript.
Как инструмент обнаруживает строковые шаблоны, такие как даты и электронные письма?

Инструмент использует регулярные выражения для сопоставления распространенных строковых шаблонов в ваших значениях JSON. Строки даты и времени в формате ISO 8601, такие как 2024-01-15T10:30:00Z, обнаруживаются и отображаются как z.string().datetime(). Строки UUID v4 отображаются как z.string().uuid(). Адреса электронной почты получают z.string().email(), URL-адреса — z.string().url(), а IP-адреса — z.string().ip(). Это означает, что ваша сгенерированная схема включает встроенную проверку для этих распространенных форматов вместо простого z.string(), что обеспечивает более точную безопасность типов и проверку из коробки.
Какова разница между строгим режимом и режимом passthrough?

В строгом режиме сгенерированная схема использует z.object().strict(), что означает, что любые свойства, не определенные в схеме, приведут к сбою валидации. Это полезно, когда вы хотите убедиться, что дополнительные данные не просачиваются. Режим passthrough использует z.object().passthrough(), который позволяет неизвестным свойствам проходить без валидации. Используйте строгий режим для данных, чувствительных к безопасности, таких как входные данные API. Используйте режим passthrough, когда вас интересуют только определенные поля, и вы хотите игнорировать остальные, например, при использовании стороннего API, который может добавлять новые поля.
Как обнаружение необязательных полей работает с массивами объектов?

Когда ваш JSON содержит массив объектов, инструмент сравнивает все объекты в массиве, чтобы определить, какие поля присутствуют в каждом элементе, а какие — только в некоторых. Поля, которые появляются во всех объектах, становятся обязательными в схеме. Поля, отсутствующие хотя бы в одном объекте, помечаются как .optional(). Это особенно полезно при работе с реальными ответами API, где некоторые записи имеют нулевые или отсутствующие поля. Инструмент интеллектуально объединяет все формы объектов, так что вы получаете одну всеобъемлющую схему, которая обрабатывает все вариации ваших данных.