# 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를 사용하세요.

여기에 광고를 게재하시겠어요?

[이메일 보내기](mailto:hi@dennn.is?subject=OneClick%20Pro%20%EA%B4%91%EA%B3%A0%20%EB%AC%B8%EC%9D%98)

[광고 433개 AI 에이전트 도구를 하나의 MCP 서버에서 제공하세요.](https://multitaskai.com/ko/?ref=oneclickpro)
