0Pricing
React Academy · Урок

Валидация схем с помощью Zod

Интегрируйте @hookform/resolvers и схемы Zod для типобезопасной валидации форм.

«Валидация схем с помощью Zod» — бесплатный урок React Academy на CoddyKit. Это урок 3 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения React Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс React Academy содержит 4 уроков всего.

Добро пожаловать

В этом уроке Вы интегрируете React Hook Form со схемами Zod через @hookform/resolvers, чтобы получить типобезопасную проверку с единым источником истины для формы и типов TypeScript.

Зачем нужна проверка схемы

Определение правил проверки непосредственно в register() становится громоздким и затрудняет повторное использование. Схема Zod определяет ALL правила проверки в одном месте, автоматически выводит типы TypeScript и может использоваться и во внешнем интерфейсе, и на сервере.

Установка

Установите Zod и пакет преобразователя RHF.
npm install zod @hookform/resolvers

Определение схемы Zod

Используйте z.object(), чтобы определить структуру формы. Для каждого поля укажите тип Zod с цепочкой методов проверки.
import { z } from 'zod';

const loginSchema = z.object({
  email: z.string().email('Invalid email'),
  password: z.string().min(8, 'At least 8 characters'),
});

Вывод типов TypeScript

Используйте z.infer, чтобы автоматически получить тип TypeScript из схемы Zod. Отдельный интерфейс не требуется.
type LoginForm = z.infer<typeof loginSchema>;
// { email: string; password: string }

Подключение к useForm через resolver

Передайте zodResolver(schema) в параметр resolver функции useForm. RHF будет использовать Zod для проверки формы вместо встроенных правил.
import { zodResolver } from '@hookform/resolvers/zod';

const { register, handleSubmit, formState } = useForm<LoginForm>({
  resolver: zodResolver(loginSchema),
});

Больше никаких встроенных правил

С zodResolver больше не нужно передавать правила в register(). Просто вызовите register('fieldName') без второго аргумента. Zod выполнит всю проверку.
<input {...register('email')} />
{errors.email && <p>{errors.email.message}</p>}

Сложные валидации Zod

Zod поддерживает мощные средства валидации: url(), uuid(), regex(), refine() для пользовательской логики и superRefine() для валидации нескольких полей.
const schema = z.object({
  url: z.string().url('Must be a valid URL'),
  confirmPassword: z.string(),
}).refine(
  data => data.password === data.confirmPassword,
  { message: 'Passwords must match', path: ['confirmPassword'] }
);

Валидация нескольких полей

refine() или superRefine() в Zod могут обращаться ко всем значениям полей, что позволяет задавать правила для нескольких полей, например: «дата окончания должна быть позже даты начала».
const schema = z.object({
  start: z.string(),
  end: z.string(),
}).refine(d => d.end > d.start, {
  message: 'End must be after start',
  path: ['end'],
});

Совместное использование схем с серверной частью

В проекте TypeScript с полной стековой архитектурой экспортируйте схему Zod из общего модуля. Используйте её и в форме React, и в обработчике API Node.js/Next.js для согласованной валидации.
// shared/schemas.ts
export const loginSchema = z.object({ ... });

// frontend — import and use as resolver
// backend — import and call .parse() on request body

Быстрая проверка

Каково главное преимущество использования z.infer для типа формы в TypeScript?

Итоги

Определите схему Zod, выведите тип TypeScript с помощью z.infer, передайте zodResolver в useForm и удалите встроенные правила валидации. Используйте refine() для валидации нескольких полей и совместно применяйте схемы во фронтенде и серверной части.

Далее

Следующий урок: **Динамические поля с useFieldArray** — Вы добавите, удалите и измените порядок динамических полей формы с помощью хука useFieldArray.

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

Урок «Валидация схем с помощью Zod» бесплатный?

Да — полный текст урока «Валидация схем с помощью Zod» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс React Academy, подпишись на CoddyKit PRO. Курс React Academy содержит 4 уроков всего.

Чему я научусь в уроке «Валидация схем с помощью Zod»?

Интегрируйте @hookform/resolvers и схемы Zod для типобезопасной валидации форм. Ты практикуешь React Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать React Academy?

Предыдущий опыт не требуется. React Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 3 из 4.

Сколько времени занимает урок «Валидация схем с помощью Zod»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке React Academy?

Да. Каждый урок React Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

  1. Начало работы с React Hook Form
  2. Правила валидации и сообщения об ошибках
  3. Валидация схем с помощью Zod
  4. Динамические поля с useFieldArray
← Назад к React Academy