Схема JSON у Zod
Перетворюйте схему JSON на схеми Zod. Типи, обов’язкові властивості, enum, 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() і згадуються в коментарі на початку результату.