Перейти к содержимому

Схема JSON в Zod

Преобразуйте схему JSON в схемы Zod. Ключевые слова type, required properties, enums, const, anyOf, oneOf и allOf преобразуются в конструкторы Zod, а распространенные ключевые слова проверки, такие как minLength, maximum, pattern, format и minItems, — в проверки Zod. Каждое определение становится экспортируемой схемой с типом z.infer.

Сбросить

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

Какие ключевые слова проверки преобразуются?

minLength и maxLength становятся .min() и .max() для строк, pattern становится .regex(), а форматы email, uri, uuid и date-time — .email(), .url(), .uuid() и .datetime(). minimum, maximum, exclusiveMinimum, exclusiveMaximum и multipleOf становятся проверками чисел, а minItems и maxItems — проверками массивов.

В каком порядке объявляются определения?

Каждое определение объявляется до схем, которые его используют. На определение, ссылающееся на себя прямо или через другие определения, ссылаются с помощью z.lazy, чтобы код продолжал работать.

Проходят ли рекурсивные схемы проверку типов?

Они работают, но TypeScript не может вывести тип схемы, которая ссылается на себя через z.lazy. Добавьте к такой схеме явную аннотацию типа, как описано в документации Zod для рекурсивных типов.

Как обрабатывается additionalProperties?

additionalProperties false добавляет .strict(); схема добавляет .catchall() с этой схемой; true добавляет .passthrough(), а объект без свойств, но со схемой additionalProperties, становится z.record(z.string(), ...).

Для какой версии Zod предназначен код?

Сгенерированные конструкторы, такие как z.object, z.union, z.record с ключевой схемой и .nullable(), есть в Zod 3 и Zod 4. В Zod 4 по-прежнему доступны строковые методы форматов, такие как .email(), хотя также предлагается сокращенная форма z.email().

Что происходит со ссылками, которые инструмент не может разрешить?

Ссылки за пределы документа, например на другой файл или URL, становятся z.unknown() и указываются в комментарии в начале результата.

О проекте OneClick Pro

OneClick Pro — это бесплатная коллекция из более чем 150 веб-инструментов для повседневных задач: преобразования изображений и единиц измерения, форматирования и проверки кода, проверки доменов и SEO, а также работы с текстом, датами и числами. Все инструменты доступны без регистрации и подписки, а введенные вами данные используются только для расчета результата и никогда не сохраняются. Используйте коллекцию как быстрый набор инструментов для разовых задач или добавьте в закладки те, которыми пользуетесь каждый день.