Схема 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() и указываются в комментарии в начале результата.