JSON to TypeScript 변환기란?
JSON to TypeScript 변환기는 JSON 객체를 분석하여 해당하는 TypeScript 인터페이스 정의를 생성합니다. API 응답, 설정 파일 또는 기타 JSON 데이터 구조에 대한 타입 정의를 수동으로 작성하는 번거로운 작업을 없애줍니다. 올바른 타입 정의는 더 나은 IDE 자동완성, 컴파일 타임 오류 감지, 안전한 코드 리팩토링을 가능하게 합니다.
사용 방법
- 입력 필드에 JSON 객체 또는 배열을 붙여넣습니다.
- 원하는 루트 인터페이스 이름을 입력합니다.
- “변환하기”를 클릭하여 TypeScript 인터페이스 정의를 생성합니다.
- 출력을 복사하여 TypeScript 프로젝트에 추가합니다.
작동 원리
변환기는 JSON 구조를 재귀적으로 순회합니다. 원시 값(string, number, boolean, null)은 해당하는 TypeScript 타입으로 매핑됩니다. 중첩된 객체는 별도의 명명된 인터페이스를 생성합니다. 배열은 요소 타입을 기반으로 타입이 지정됩니다. 배열에 혼합 타입이 포함된 경우 유니온 타입이 생성됩니다.
자주 묻는 질문
선택적 속성은 어떻게 되나요?
변환기는 단일 JSON 샘플에서 작동하므로 모든 속성이 필수로 표시됩니다. 일부 API 응답에서 속성이 없을 수 있는 경우, 생성된 인터페이스에서 속성 이름 뒤에 선택적 표시(?)를 수동으로 추가하세요.
깊게 중첩된 JSON을 처리할 수 있나요?
네. 각 중첩 객체는 속성 키에서 파생된 PascalCase 이름으로 자체 인터페이스를 생성합니다. 예를 들어, 중첩된 “address” 속성은 별도의 “Address” 인터페이스를 생성합니다.