본문으로 건너뛰기

JSON 스키마를 TypeScript로 변환

JSON 스키마를 TypeScript 유형으로 변환합니다. 객체는 필수 및 선택적 속성이 있는 인터페이스가 되고, $defs와 definitions는 $ref가 가리키는 이름 있는 내보내기가 됩니다. enum과 const는 리터럴 유형이 되고, anyOf와 oneOf는 유니온으로, allOf는 인터섹션으로 변환됩니다. 설명은 문서 주석으로 유지됩니다.

초기화

자주 묻는 질문

지원되는 JSON 스키마 초안은 무엇인가요?

변환기는 draft-07, 2019-09 및 2020-12에서 공통으로 사용하는 키워드를 읽습니다. type, properties, required, additionalProperties, items, prefixItems, enum, const, anyOf, oneOf, allOf, 그리고 $ref에서 $defs 또는 definitions까지 지원합니다. minLength나 pattern 같은 유효성 검사 키워드는 TypeScript에 해당하는 기능이 없어 제외됩니다.

$ref 참조는 어떻게 확인하나요?

#, #/$defs/Name 및 #/definitions/Name에 대한 참조는 해당 정의의 이름 있는 유형이 됩니다. 다른 파일이나 URL을 가리키는 참조처럼 그 밖의 참조는 unknown 유형으로 처리되며 출력 상단의 주석에 표시됩니다.

additionalProperties는 어떻게 처리하나요?

속성이 없고 additionalProperties 스키마가 있는 객체는 Record<string, T>가 됩니다. 속성과 additionalProperties 스키마가 모두 있는 객체는 인터페이스와 Record<string, T>를 결합합니다. additionalProperties가 false이거나 키워드가 없으면 아무것도 추가되지 않습니다. TypeScript 객체 유형은 이미 알려진 키를 설명하기 때문입니다.

nullable은 어떤 역할을 하나요?

OpenAPI 3.0의 nullable: true 키워드와 Swagger의 x-nullable 확장은 유형에 | null을 추가합니다. JSON Schema 자체에서는 type: ["string", "null"]로 작성하면 string | null이 됩니다.

재귀 스키마를 지원하나요?

예. 자신이나 다른 정의를 $ref를 통해 참조하는 정의는 다른 이름을 참조하는 이름 있는 유형이 되며, TypeScript가 이를 문제없이 확인합니다.

스키마가 유효한지 검사하나요?

스키마를 읽기만 합니다. 알 수 없는 키워드는 무시되고, 유형이 없는 스키마는 unknown이 됩니다. 스키마에 맞춰 데이터를 검사하려면 JSON Schema Validator를 사용하세요.

OneClick Pro 소개

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