본문으로 건너뛰기

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()가 되며 출력 상단의 주석에 표시됩니다.

OneClick Pro 소개

OneClick Pro은 일상 업무에 활용할 수 있는 150개 이상의 웹 도구를 무료로 모아 제공합니다. 이미지와 단위를 변환하고, 코드를 포맷하고 검증하고, 도메인과 SEO를 확인하고, 텍스트와 날짜, 숫자를 다룰 수 있습니다. 모든 도구는 가입이나 구독 없이 사용할 수 있으며, 입력한 내용은 결과를 계산하는 데만 사용되고 저장되지 않습니다. 한 번 쓰는 작업을 위한 빠른 도구 모음으로 활용하거나, 매일 자주 쓰는 도구를 북마크해 두세요.