본문으로 건너뛰기
타입 도구

JSON → TypeScript 타입 생성

JSON 샘플에서 TypeScript 타입(type Root = { ... };)을 만듭니다. API 응답이나 설정 파일을 붙여넣기만 하면 타입을 붙이는 출발점이 생깁니다. 배열 요소의 모양이 다르면 하나의 타입으로 합치고 일부 요소에만 있는 키는 email?: string 같은 선택적 키로 만듭니다. 빈 배열은 unknown[], null을 포함하는 값은 string | null 같은 유니온 타입이 됩니다. 숫자는 정수든 소수든 number, 날짜 문자열은 string이며 중첩된 객체에는 별도 이름을 붙이지 않고 중첩된 채로 출력합니다. 샘플 하나에서 추론하므로 필수 여부·열거형·공통 타입 분리는 사양에 맞게 직접 고치세요. 모든 처리는 브라우저 안에서 이루어지며 JSON은 전송되지 않습니다.

다른 언어: Go, Python, Rust, Kotlin, C#

위의 JSON을 다른 언어의 타입으로 바꿉니다. Go 구조체(json 태그 포함), Python TypedDict(3.11 이상), Rust serde 구조체, Kotlin data class(kotlinx.serialization), C# 클래스(System.Text.Json)를 지원합니다. 중첩 객체는 이름 있는 타입이 되고 없는 키는 선택 항목이 되며 데이터는 전송되지 않습니다.

가이드

사용 방법 및 특징

  • 입력 칸에 JSON을 붙여넣고 “TypeScript로 변환”을 누릅니다.
  • 객체는 속성별 타입이 포함된 블록 형태로 정리됩니다.
  • 배열은 요소 타입을 판단하며, 여러 타입이 섞이면 유니온으로 표시합니다.
  • 결과를 복사하거나 필드를 지워서 다시 시도할 수 있습니다.
샘플

입출력 예시

Generate TypeScript types

입력 예시
{"title":"Draft","tags":["dev","web"],"stats":{"views":1200}}
출력 예시
type Root = {
    title: string;
    tags: string[];
    stats: {
        views: number;
    };
};
FAQ

자주 묻는 질문

  • 어떤 타입이 출력되나요?

    `type Root = { ... };` 형태의 타입 별칭입니다. 중첩된 객체는 별도 이름 없이 중첩된 채로 출력합니다. 이름을 바꾸거나 `interface`로 하고 싶다면 직접 고쳐 주세요.
  • 배열 요소의 모양이 다르면 어떻게 되나요?

    요소를 하나의 타입으로 합칩니다. 일부 요소에만 있는 키는 `email?: string`처럼 선택적 키가 됩니다. 값의 종류가 다를 때만 `string | number` 같은 유니온 타입이 됩니다.
  • 빈 배열이나 `null`은 어떻게 되나요?

    빈 배열은 요소 타입을 알 수 없으므로 `unknown[]`이 됩니다(`any[]`가 아닙니다). `null`을 포함하는 값은 `string | null` 같은 유니온 타입이 됩니다.
  • 정수·소수·날짜는 구분되나요?

    구분되지 않습니다. 숫자는 모두 `number`, 날짜 문자열도 `string`입니다. `Date`나 `bigint`는 되지 않습니다.
  • `my-key`처럼 식별자가 될 수 없는 키는요?

    `"my-key": string;`처럼 따옴표로 감싸 출력합니다.
  • 입력한 JSON이 전송되나요?

    전송되지 않습니다. 변환은 모두 브라우저 안에서 이루어집니다.
활용

주요 활용 사례

  • 타입 정의의 출발점 만들기

    백엔드 응답 예시에서 TypeScript 인터페이스를 생성해 타입 안전한 구현을 빠르게 시작합니다.
  • 계약 맞추기

    공유한 JSON을 타입으로 바꿔 필드 이름, 선택 여부, 구조에 대한 기대를 분명히 합니다.
  • 가벼운 리뷰용 조각

    PR 댓글에 붙여 넣을 최소한의 인터페이스를 만들어, 오타가 아니라 구조에 논의를 집중합니다.
주의

주의 사항·제한

  • 샘플 하나에서 추론합니다

    JSON에 나타난 값만 보고 타입을 만듭니다. "이 값은 사실 열거형", "이 키는 필수" 같은 사양 정보는 포함되지 않습니다. 반드시 내용을 확인하세요.
  • 중첩된 객체에는 이름이 붙지 않습니다

    중첩된 채로 출력하므로 같은 모양이 여러 번 나와도 공통 타입으로 합쳐지지 않습니다. 필요하면 `type User = ...`처럼 직접 분리하세요.
  • 사전 같은 JSON은 `Record`가 되지 않습니다

    키가 ID처럼 달라지는 객체도 보인 키만 가진 타입이 됩니다. `Record<string, T>`가 알맞을 때는 직접 고치세요.
  • 큰 정수는 반올림됩니다

    JavaScript 숫자로 정확히 나타낼 수 없는 큰 정수는 JSON을 읽는 시점에 반올림됩니다. ID 등은 문자열로 받는 설계를 고려하세요.
소개

이 도구에 대하여

JSON에서 TypeScript 타입 생성

샘플 JSON을 TypeScript type 또는 interface로 변환합니다. API 응답, 테스트 fixture, mock 데이터를 빠르게 타입화해 React, Next.js, Vue 같은 TypeScript 프로젝트에서 활용할 수 있습니다.

활용 예시

  • API 응답 타입 작성: 실제 payload에서 타입 초안을 만듭니다.
  • 데이터 구조 문서화: JSON 구조를 팀원이 읽기 쉬운 타입으로 정리합니다.
  • 프로토타이핑: 외부 API를 탐색할 때 초기 타입을 빠르게 생성합니다.

생성 결과는 샘플 기반입니다. optional field, null, mixed array, error response는 직접 검토하세요.

이 도구의 관련 기사

최신 아티클