JSON에서 TypeScript로

예시

입력:

{ "id": 1, "name": "Alice", "age": null, "tags": ["admin", "user"], "address": { "city": "Madrid" } }

출력:

interface User {
  id: number;
  name: string;
  age: number | null;
  tags: string[];
  address: Address;
}

interface Address {
  city: string;
}

타입 매핑

선택적 필드와 null 허용 필드

• foo?: string, 해당 필드가 객체에 없을 수 있습니다. undefined 검사가 필요합니다.
• foo: string | null, 해당 필드는 항상 존재하지만 명시적으로 null일 수 있습니다.
• foo?: string | null, 없거나 null일 수 있습니다.

JSON 자체에는 undefined가 없지만, 필드 부재를 표현하는 방식은 API마다 다릅니다. 사용하는 API의 시맨틱에 맞추세요.

• REST API는 일반적으로 누락된 필드를 생략합니다 -> ?:.
• GraphQL은 요청된 모든 필드를 항상 반환합니다 -> | null.
• 일부 SDK는 상황에 따라 두 방식을 함께 사용합니다.

유니온 타입 vs 리터럴 타입

여러 샘플에 걸쳐 동일한 문자열 필드가 소수의 값만 갖는 경우("status": "pending", "active", "archived"), 도구는 문자열 리터럴 유니온을 출력할 수 있습니다.

status: "pending" | "active" | "archived";

이 동작이 필요하면 “문자열 리터럴 유니온 추론”을 활성화하세요.

흔한 실수

• 단일 샘플로 추론하기. 모든 필드가 필수가 되고 null 허용 여부를 관찰할 수 없습니다. 더 정확한 타입을 얻으려면 다양한 샘플 5~10개를 제공하세요.
• 빈 배열. "tags": []는 타입 정보를 제공하지 않아 생성기가 unknown[]을 출력합니다. 요소가 최소 하나 이상 포함된 샘플을 제공하세요.
• 혼합 타입 배열. [1, "two", true]는 (number | string | boolean)[]을 생성합니다. 보통 이는 JSON에 타입을 지정하기보다 구조를 다시 설계해야 함을 의미합니다.
• 숫자 문자열 키. JSON {"1": "a", "2": "b"}는 TypeScript에서 여전히 객체(Record<string, string>)이며 배열이 아닙니다. 생성기는 이를 올바르게 처리합니다.