JSON 스키마를 Zod로 변환
JSON 스키마를 Zod 스키마로 변환합니다. 유형, 필수 속성, 열거형, 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()가 되며 출력 상단의 주석에 표시됩니다.