JSON에서 Zod 검증 스키마 생성
업로드 0바이트JSON 페이로드를 타입 안전한 Zod 런타임 검증기(`z.object`, `z.union`, `.nullable()`)와 `z.infer` TypeScript 내보내기로 바꾸세요.
여기에 텍스트 또는 데이터 파일 드롭 · Ctrl V로 붙여넣기 · 또는 .json 드롭 · Ctrl V로 JSON 붙여넣기
- 100% 브라우저 로컬
- z.infer TypeScript 타입 출력
- 엄격 .strict() 모드 지원
변환 전/후 즉시 미리보기
{
"eventId": "evt_991",
"attempt": 1,
"payload": {
"success": true,
"tags": ["billing"]
}
}import { z } from "zod";
export const rootSchema = z.object({
eventId: z.string(),
attempt: z.number(),
payload: z.object({
success: z.boolean(),
tags: z.array(z.string()),
}),
});
export type RootSchema = z.infer<typeof rootSchema>;원본 및 대상 형식 사양 비교: JSON → Zod 스키마
| 속성 | 원본: JSON | 대상: Zod 스키마 |
|---|---|---|
| 구조 유형 | 계층형 | 타입 코드 |
| 사람 가독성 | 높음 | 높음 |
| 중첩 지원 | 지원 | 지원 |
| LLM 토큰 효율 | 낮음 | 보통 |
| 파일 확장자 | .json | .ts |
| MIME 유형 | application/json | text/typescript |
| 추천 용도 | REST/GraphQL API, 구조화된 앱 상태 관리, NoSQL 문서, 시스템 간 데이터 교환. | 런타임 API 경계 검증, tRPC/React Hook Form 스키마 및 단일 소스 TypeScript 타입 추론. |
작동 방식
로컬에서 JSON으로 Zod 스키마를 생성하는 방법
JSON 예제에서 즉석으로 생성한 Zod 검증 스키마로 API 엔드포인트와 폼 핸들러를 안전하게 보호합니다.
- 샘플 JSON 붙여넣기웹훅 페이로드, 설정 객체 또는 REST JSON 응답을 드롭하거나 붙여넣으세요.
- 스키마 옵션 설정스키마 이름을 정하고 z.infer 타입 생성 여부 및 z.strictObject() / .strict() 적용을 선택하세요.
- Zod 모듈 복사생성된 Zod 검증 코드를 TypeScript 프로젝트나 tRPC 라우터에 바로 붙여넣으세요.
FAQ
자주 묻는 질문
JSON to Zod는 일부 요소에서 빠진 선택적 속성이나 null도 처리하나요?
네. 배열 항목 간 누락된 속성에는 .optional()을, null 값에는 .nullable()을 자동으로 생성합니다.
생성된 Zod 스키마에서 엄격한 z.strictObject()는 언제 켜야 하나요?
알 수 없는 추가 키가 들어왔을 때 반드시 검증 오류를 내야 하는 경우 켜고, 외부 필드를 유연하게 걸러내려면 끄는 것이 좋습니다.
출력 코드에 z.infer TypeScript 타입 별칭도 함께 포함되나요?
네. 'z.infer TypeScript 타입 내보내기'를 켜 두면 스키마 바로 아래에 export type ... = z.infer<typeof ...> 구문이 함께 생성됩니다.