본문으로 건너뛰기

JSON을(를) TypeScript로

JSON 샘플을 TypeScript 인터페이스 또는 타입 별칭으로 변환합니다. 중첩 객체는 각각 별도의 이름 있는 타입이 되고, 객체 배열은 병합되어 일부 항목에 없는 키가 선택 사항으로 표시되며, 여러 유형의 값은 유니온 타입이 됩니다. API 응답을 붙여넣고 인터페이스 또는 타입을 선택한 다음 코드에 바로 넣을 수 있는 선언을 복사하세요.

초기화

자주 묻는 질문

중첩 객체는 어떻게 처리하나요?

중첩 객체마다 해당 객체를 포함하는 키를 기반으로 PascalCase 이름을 붙인 선언이 생성됩니다. 예를 들어 address는 Address가 됩니다. 배열 안의 객체는 배열 키의 단수형을 이름으로 사용하므로 users는 User, categories는 Category가 됩니다. 필드가 정확히 같은 객체는 하나의 선언을 공유합니다.

속성은 언제 선택 사항이 되나요?

배열에 여러 객체가 있고 일부 객체에 키가 없으면 해당 키는 물음표로 선택 사항임을 표시합니다. 모든 항목에 있는 키는 필수로 유지됩니다. 단일 객체는 비교할 다른 샘플이 없으므로 모든 키가 필수입니다.

null 값은 어떻게 타입이 지정되나요?

샘플에서 null인 키는 null 타입으로 지정되고, 일부 항목에서는 null이고 다른 항목에서는 문자열인 키는 string | null이 됩니다. 실제 데이터에서 필드가 null일 수 있지만 샘플에는 null이 없다면 직접 null을 추가하거나 null이 포함된 샘플을 붙여넣으세요.

interface와 type 중 무엇을 선택해야 하나요?

둘 다 같은 구조를 설명합니다. 인터페이스는 확장 및 병합이 가능해 객체 구조에 인터페이스를 선호하는 스타일 가이드가 많습니다. 타입 별칭은 유니온에도 사용할 수 있으며, 일부 팀은 모든 곳에서 타입 별칭을 사용합니다. 코드베이스에서 사용하는 방식을 선택하면 필드는 동일합니다.

배열의 타입은 어떻게 지정되나요?

한 종류의 값으로 이루어진 배열은 string[] 또는 User[]처럼 해당 타입 뒤에 []가 붙습니다. 여러 종류의 값이 있는 배열은 (string | number)[]처럼 괄호 안에 유니온 타입을 사용합니다. 빈 배열은 항목에 대한 정보가 샘플에 없으므로 unknown[]이 됩니다.

유효한 식별자가 아닌 키는 어떻게 되나요?

공백, 대시 또는 TypeScript 식별자에 허용되지 않는 문자가 포함된 키는 따옴표로 감쌉니다. 예를 들어 "first-name": string처럼 작성되며, 이는 유효한 TypeScript이고 JSON와 정확히 일치합니다.

숫자는 정수 또는 실수로 타입이 지정되나요?

TypeScript에는 숫자 타입이 하나뿐이므로 정수와 소수 모두 number가 됩니다. 어떤 값이 정수인지 알아야 한다면 JSON 스키마 생성기가 integer와 number를 구분합니다.

루트 타입의 이름을 바꿀 수 있나요?

예. ApiResponse와 같은 루트 타입 이름을 입력하세요. 이름은 PascalCase로 변환되고, 중첩 타입은 키에서 파생된 이름을 유지합니다. JSON의 최상위 수준이 배열 또는 단일 값이면 루트는 해당 값을 위한 타입 별칭이 됩니다.

날짜를 감지하나요?

아니요. JSON에는 날짜 타입이 없으므로 샘플의 날짜는 문자열이며 string으로 타입이 지정됩니다. 파싱한 뒤 코드에서 Date로 변환하거나, 템플릿 리터럴 타입을 사용한다면 직접 타입을 좁히세요.

JSON의 최대 크기는 얼마인가요?

최대 1,000,000자까지 입력할 수 있으며, 중첩 깊이는 최대 64단계입니다. 샘플은 타입을 생성하기 위해서만 분석하며 저장하지 않습니다.

OneClick Pro 소개

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