출처 URL: https://zod.dev/

Zod

TypeScript 우선 스키마 유효성 검사 및 정적 타입 추론
작성자 @colinhacks

GitHub Actions • MIT 라이선스 • npm 패키지 • GitHub 저장소

웹사이트 • Discord • 𝕏 • Bluesky

Zod 4가 이제 안정화되었습니다! 릴리스 노트 읽기.

추천 스폰서: Jazz

Jazz

스폰서로 소개되길 원하시면 문의하기

소개

Zod는 TypeScript 우선 유효성 검사 라이브러리입니다. Zod를 사용하면 간단한 string부터 복잡한 중첩 객체까지 데이터를 검증하는 스키마를 정의할 수 있습니다.

    import * as z from "zod";

    const User = z.object({
      name: z.string(),
    });

    // 일부 신뢰되지 않은 데이터...
    const input = { /* stuff */ };

    // 구문 분석된 결과는 검증되며 타입 안전합니다!
    const data = User.parse(input);

    // 그러므로 안심하고 사용할 수 있습니다 :)
    console.log(data.name);

특징

외부 의존성 없음
Node.js 및 모든 최신 브라우저에서 작동
작음: 코어 번들 2kb (gzip)
불변 API: 메서드는 새 인스턴스 반환
간결한 인터페이스
TypeScript 및 일반 JS와 호환
내장 JSON Schema 변환
광범위한 생태계

설치

    npm install zod

Zod는 jsr.io에서 @zod/zod로도 제공됩니다.

Zod는 에이전트가 Zod 문서를 검색할 수 있는 MCP 서버를 제공합니다. 에디터에 추가하려면 이 지침을 따르세요. Zod는 또한 llms.txt 파일을 제공합니다.

요구 사항

Zod는 TypeScript v5.5 이상에서 테스트되었습니다. 이전 버전도 작동할 수 있지만 공식적으로 지원되지 않습니다.

"strict"

tsconfig.json에서 strict 모드를 반드시 활성화해야 합니다. 이는 모든 TypeScript 프로젝트에 대한 권장 사항입니다.

    {
      // ...
      "compilerOptions": {
        // ...
        "strict": true
      }
    }

생태계

Zod는 활발한 라이브러리, 도구, 통합 생태계를 갖추고 있습니다. Zod를 지원하거나 그 위에 구축된 라이브러리의 전체 목록은 생태계 페이지를 참고하세요.

다음 프로젝트에도 기여하고 있으며 강조하고 싶습니다:

tRPC - Zod 스키마를 지원하는 종단간 타입 안전 API
React Hook Form - Zod resolver를 사용하는 훅 기반 폼 검증
zshy - 원래 Zod 내부 빌드 도구로 만들어졌습니다. 번들러 없이 TypeScript 라이브러리를 위한 만능 빌드 도구. tsc 기반.