0Pricing
React Academy · 강의

Zod로 스키마 유효성 검사하기

@hookform/resolvers와 Zod 스키마를 통합해 형식이 안전한 양식 유효성 검사를 구현합니다.

Zod로 스키마 유효성 검사하기은(는) CoddyKit의 무료 React Academy 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 React Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. React Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

환영합니다

이 학습에서는 @hookform/resolvers를 통해 React Hook Form과 Zod 스키마를 통합하여 양식과 TypeScript 타입 모두에 대한 단일 기준으로 형식 안전한 검증을 구현합니다.

스키마 검증을 사용하는 이유

register()에 검증 규칙을 인라인으로 정의하면 코드가 장황해지고 재사용하기 어려워집니다. Zod 스키마는 모든 검증을 한곳에 정의하고, 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를 사용해 Zod 스키마에서 TypeScript 타입을 자동으로 도출합니다. 별도의 interface가 필요하지 않습니다.
type LoginForm = z.infer<typeof loginSchema>;
// { email: string; password: string }

resolver를 통해 useForm 연결하기

zodResolver(schema)를 useForm의 resolver 옵션에 전달합니다. 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'] }
);

필드 간 검증

Zod의 refine() 또는 superRefine()는 모든 필드 값에 접근할 수 있으므로, 종료 날짜가 시작 날짜 이후여야 한다는 규칙과 같은 필드 간 규칙을 적용할 수 있습니다.
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 폼 AND Node.js/Next.js API 처리기 양쪽에서 사용합니다.
// shared/schemas.ts
export const loginSchema = z.object({ ... });

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

간단한 확인

TypeScript에서 폼 타입에 z.infer를 사용하는 주요 장점은 무엇인가요?

복습

Zod 스키마를 정의하고, z.infer로 TypeScript 타입을 추론한 다음, zodResolver를 useForm에 전달하고 인라인 검증 규칙을 제거합니다. 필드 간 검증에는 refine()을 사용하고 프런트엔드와 백엔드 간에 스키마를 공유합니다.

다음 학습 내용

다음 레슨: **useFieldArray를 사용한 동적 필드** — useFieldArray 훅으로 동적 폼 필드를 추가하고 제거하며 순서를 변경합니다.

자주 묻는 질문

“Zod로 스키마 유효성 검사하기” 강의는 무료인가요?

네 — “Zod로 스키마 유효성 검사하기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 React Academy 강의 전체를 잠금 해제할 수 있습니다. React Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“Zod로 스키마 유효성 검사하기”에서 뭘 배우나요?

@hookform/resolvers와 Zod 스키마를 통합해 형식이 안전한 양식 유효성 검사를 구현합니다. 브라우저에서 직접 실행하는 실습 코드로 React Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

React Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 React Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.

“Zod로 스키마 유효성 검사하기” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 React Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 React Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. React Hook Form 시작하기
  2. 유효성 검사 규칙과 오류 메시지
  3. Zod로 스키마 유효성 검사하기
  4. useFieldArray로 동적 필드 다루기
← React Academy(으)로 돌아가기