JSON → Zod 스키마 생성
JSON 샘플에서 Zod 스키마를 만듭니다. import { z } from 'zod', z.object({...}) 스키마, z.infer로 타입을 꺼내는 한 줄이 출력되므로 그대로 붙여 schema.parse(data)로 API 응답 등을 검증할 수 있습니다. 배열 요소의 모양이 다르면 하나로 합치고 일부 요소에만 있는 키는 .optional(), "문자열 또는 null" 같은 값은 .nullable()이 됩니다. 빈 배열은 z.array(z.unknown())입니다. 숫자는 정수든 소수든 z.number(), 날짜 문자열도 z.string()이므로 .int()·.datetime()이나 글자 수·범위 제약은 직접 추가하세요. 샘플 하나에서 추론합니다. 모든 처리는 브라우저 안에서 이루어지며 JSON은 전송되지 않습니다.
다른 검증기: Valibot, JSON Schema
같은 JSON에서 Valibot 스키마나 JSON Schema(draft 2020-12)를 만듭니다. 배열 요소는 하나로 합쳐지고 일부 객체에만 있는 키는 선택 항목이 됩니다. 위의 문자열 형식 옵션과 루트 이름도 반영됩니다.
가이드사용 방법 및 특징
- 입력 칸에 JSON을 붙여넣고 “Zod로 변환”을 누릅니다.
- 객체는 `z.object({...})` 형태로 정리되며, 중첩 구조도 자동 생성됩니다.
- 배열은 요소 타입을 추론하고, 여러 타입이 섞이면 `z.union([...])`으로 표현합니다.
- 복사 또는 지우기 버튼으로 결과를 재사용하거나 다시 시작하세요.
샘플입출력 예시
Convert JSON to Zod schema
{"id":42,"enabled":false,"labels":["alpha","beta"]}const Schema = z.object({
id: z.number(),
enabled: z.boolean(),
labels: z.array(z.string()),
});FAQ자주 묻는 질문
어떤 코드가 출력되나요?
`import { z } from 'zod'`, `z.object({...})` 스키마, `z.infer`로 타입을 꺼내는 한 줄의 세 가지입니다. 그대로 프로젝트에 붙여 `schema.parse(data)`로 검증할 수 있습니다.배열 요소의 모양이 다르면 어떻게 되나요?
요소를 하나의 타입으로 합칩니다. 일부 요소에만 있는 키는 `.optional()`이 됩니다. 문자열과 숫자처럼 값의 종류가 다를 때만 `z.union`이 됩니다.`null`은 어떻게 처리되나요?
"문자열 또는 null" 같은 경우에는 `.nullable()`을 붙입니다. 값이 `null`뿐인 키는 `z.null()`이 됩니다.정수나 날짜는 `.int()`나 `.datetime()`이 되나요?
되지 않습니다. 숫자는 정수든 소수든 `z.number()`, 날짜 문자열도 `z.string()`입니다. 필요한 제약은 출력에 직접 추가하세요.빈 배열은 어떻게 되나요?
요소 타입을 알 수 없으므로 `z.array(z.unknown())`이 됩니다. 실제 데이터의 타입으로 바꿔 주세요.입력한 JSON이 전송되나요?
전송되지 않습니다. 변환은 모두 브라우저 안에서 이루어집니다.
활용주요 활용 사례
폼 검증 초안 작성
백엔드 예시에서 Zod 스키마를 생성해 프런트엔드 검증 로직에 바로 적용합니다.목 데이터 검증
로컬 목 JSON을 Zod로 파싱해 예상치 못한 필드나 구조를 런타임에 잡아냅니다.스키마 조각 공유
생성된 조각을 복사해 여러 라이브러리에서 재사용하고, 런타임 검사를 타입과 일치시킵니다.
주의주의 사항·제한
샘플 하나에서 추론합니다
JSON에 나타난 값의 "모양"만 보고 만듭니다. 가능한 값의 범위, 열거형(enum), 글자 수, 이메일 형식 같은 제약은 알 수 없습니다. 사양에 맞게 고치세요.필수 여부는 샘플에 따라 달라집니다
배열의 모든 요소에 있는 키는 필수, 일부에만 있는 키는 `.optional()`이 됩니다. 실제 사양과 맞는지 확인하세요.정수·날짜 제약은 들어가지 않습니다
`z.number()`와 `z.string()` 그대로입니다. 정수로 제한하려면 `.int()`, 날짜라면 `.datetime()` 등을 추가하세요.입력은 엄격한 JSON만 가능합니다
주석이나 끝의 쉼표 등 JSON이 아닌 표기는 오류가 됩니다. JavaScript가 정확히 다루지 못하는 큰 정수는 반올림됩니다.
소개이 도구에 대하여
JSON에서 Zod 스키마 생성
샘플 JSON을 기반으로 Zod schema를 생성해 런타임 검증 코드를 빠르게 준비할 수 있습니다. 외부 API, form, webhook, storage에서 들어오는 데이터를 사용하기 전에 구조를 확인할 때 유용합니다.
자주 쓰는 상황
- 외부 API 검증: 실제 응답에서 schema 초안을 만듭니다.
- 입력 경계 보호: 앱 내부로 들어오기 전 데이터를 확인합니다.
- 테스트 준비: 예상 payload 구조를 schema로 문서화합니다.
샘플에 없는 optional field, enum, nullable 값은 실제 계약에 맞게 조정해야 합니다.
이 도구의 관련 기사
Zod를 사용하여 JSON 유효성 검사 간소화하기
TypeScript 친화적인 스키마 정의 라이브러리인 'Zod'를 사용하여 JSON 데이터의 런타임 유효성 검사와 타입 생성을 자동화하는 방법을 소개합니다.
JSON Schema와 Zod를 상호 변환하는 원리|required와 .optional()의 대응
JSON Schema와 Zod 스키마를 양방향으로 변환하는 변환기의 구현을 해설합니다. required와 .optional()의 기본값이 반대인 문제, 제약 조건 대응표, 코드를 실행하지 않고 해석하는 방법을 다룹니다.
JSON 포맷팅과 검증: API 응답을 안전하게 확인하는 방법
JSON을 보기 좋게 정리하고, 문법 오류와 값의 타입을 확인하며, TypeScript 타입과 Zod, OpenAPI 스키마로 이어지는 실무 흐름을 설명합니다.
JSON 에코시스템 입문: 포맷팅·타입 생성·검증·API 정의를 예제로 잇기
JSON을 기점으로 TypeScript 타입, Zod 런타임 검증, OpenAPI 정의로 전개하는 일련의 흐름을 실제 코드로 이어 해설. 타입 안전한 API 개발의 전체 그림을 알 수 있습니다.
JSON에서 TypeScript 타입을 자동 생성하는 방법: 실제 예제로 배우는 변환 요령
API 응답 JSON을 타입 안전한 TypeScript 인터페이스로 변환하는 절차를 실제 변환 예제와 함께 해설. null·배열·중첩·명명 요령과 수동 보정까지 다룹니다.
