소개
Zod 4가 안정화되었습니다. 릴리스 노트와 마이그레이션 가이드를 읽어보세요.
소개
Zod는 TypeScript 우선 검증 라이브러리입니다. Zod를 사용하면 간단한 string부터 복잡한 중첩 객체까지 데이터를 검증하는 데 사용할 스키마를 정의할 수 있습니다.
import * as z from "zod";
const User = z.object({
name: z.string(),
});
// some untrusted data...
const input = { /* stuff */ };
// the parsed result is validated and type safe!
const data = User.parse(input);
// so you can use it with confidence :)
console.log(data.name);
특징
- 외부 의존성 없음
- Node.js와 모든 최신 브라우저에서 작동
- 작은 크기: 코어 번들 2kb(gzip 압축 기준)
- 불변 API: 메서드가 새 인스턴스를 반환
- 간결한 인터페이스
- TypeScript와 일반 JavaScript에서 작동
- JSON Schema 변환 기능 내장
- 광범위한 생태계
설치
npm install zod
Zod는 jsr.io에서
@zod/zod로도 사용할 수 있습니다.
Zod는 에이전트가 Zod 문서를 검색하는 데 사용할 수 있는 MCP 서버를 제공합니다. 편집기에 추가하려면 이 안내를 따르세요. Zod는 llms.txt 파일도 제공합니다.
요구 사항
Zod는 TypeScript v5.5 이상에서 테스트됩니다. 이전 버전도 작동할 수 있지만 공식적으로 지원하지 않습니다.
"strict"
strict 모드를 tsconfig.json에서 활성화해야 합니다. 이는 모든 TypeScript 프로젝트에 권장되는 모범 사례입니다.
// tsconfig.json
{
// ...
"compilerOptions": {
// ...
"strict": true
}
}
생태계
Zod에는 다양한 라이브러리, 도구, 통합으로 이루어진 활발한 생태계가 있습니다. Zod를 지원하거나 Zod를 기반으로 구축된 라이브러리의 전체 목록은 생태계 페이지를 참조하세요.
다음 프로젝트에도 기여하고 있으며, 특히 소개하고자 합니다.
- tRPC - Zod 스키마를 지원하는 엔드투엔드 타입 안전 API
- React Hook Form - Zod 리졸버를 제공하는 훅 기반 폼 검증
- zshy - 원래 Zod의 내부 빌드 도구로 만들어졌습니다. TypeScript 라이브러리를 위한 번들러 없는 올인원 빌드 도구이며
tsc를 기반으로 합니다.
후원자
어떤 수준의 후원이든 감사히 받습니다. Zod를 사용해 유료 제품을 만들었다면 기업 후원 등급 중 하나를 고려해 주세요.
플래티넘
골드
실버
SanitySubtotalNitricPropelAuthCerbosScalarTransloaditWhopCryptoJobsListPlainInngestStoryblokMuxCybozu9thCOFerry Health