본문으로 건너뛰기
툴허브

JSON → TypeScript 변환기

JSON을 붙여넣으면 TypeScript interface·type 선언을 바로 만들어요. 선택 필드(?), null 합집합, 배열 원소 타입, 중첩 객체 이름까지 자동으로 추론해요.

TypeScript 결과선언 5개결과 보기 ↓

선언 방식

키워드

브라우저 안에서만 변환해요. 입력한 JSON은 서버로 보내지 않아요.

TypeScript 결과

선언 5개

export interface Root {
  id: number;
  title: string;
  published: boolean;
  createdAt: string;
  author: Author;
  tags: string[];
  comments: Comment[];
  settings: Settings;
}

export interface Author {
  id: number;
  nickname: string;
  avatarUrl: null;
}

export interface Comment {
  id: number;
  body: string;
  likes: number;
  editedAt: string | null;
  replyTo?: number;
}

export interface Settings {
  visibility: string;
  notify: Notify;
}

export interface Notify {
  email: boolean;
  push: boolean;
}

JSON → TypeScript 변환 가이드

타입을 정하는 규칙

  • 문자열·숫자·불리언은 string·number·boolean이 돼요. 숫자는 정수와 실수를 나누지 않고 모두 number예요.
  • 값이 null뿐이면 null, 다른 값과 섞여 있으면 string | null처럼 합집합 타입이 돼요.
  • 객체 배열에서 일부 항목에만 있는 키는 선택 필드(?)로 표시하고, 항목마다 값 타입이 다르면 합집합으로 묶어요.
  • 배열은 원소 타입을 모아 number[]·(string | number)[]처럼 만들어요. 빈 배열은 원소를 알 수 없어 unknown[], 배열 안의 배열은 number[][]가 돼요.
  • 빈 객체 {}는 모양을 알 수 없어 Record<string, unknown>으로 둬요.
  • 날짜처럼 보이는 값도 JSON에서는 문자열이라 string으로 둬요.

타입 이름 짓는 방식

  • 중첩 객체는 키 이름을 PascalCase로 바꿔 따로 선언해요. user_profile은 UserProfile이 돼요.
  • 배열 원소는 단순한 영어 복수형을 단수로 바꿔요. items는 Item, categories는 Category. 복수형이 아니면 data는 DataItem처럼 Item을 붙여요.
  • 이름이 겹치면 User2처럼 번호를 붙여요. Date·Record·Promise처럼 내장 타입과 같은 이름도 번호를 붙여 피하고, export를 끄면 전역 선언과 합쳐지지 않도록 Location·Comment 같은 브라우저(DOM) 타입 이름도 피해요.
  • 모양이 완전히 같은 객체는 한 번만 선언하고 그 이름을 다시 써요.
  • 하이픈·공백이 있거나 숫자로 시작하는 키는 "first-name"처럼 따옴표로 감싸요.
  • 최상위가 배열이나 원시값이면 type Root = Item[]처럼 타입 별칭으로 만들어요.

실무 팁

  • API 응답은 한 건보다 여러 건을 배열로 묶어 넣으세요. 항목마다 빠진 키가 선택 필드로 잡혀 실제 응답에 더 가까워져요.
  • 샘플에 없던 경우는 추론할 수 없어요. null로만 온 필드는 실제 타입을 직접 적어 주세요(예: string | null).
  • TypeScript 타입은 컴파일할 때만 검사해요. 서버 응답이 정말 이 모양인지는 zod·valibot 같은 런타임 검증 라이브러리로 확인하는 게 안전해요.
  • status처럼 정해진 값만 오는 필드는 'active' | 'inactive' 같은 리터럴 유니온으로 바꾸면 더 정확해요.
  • interface는 선언 병합과 extends에, type은 유니온·교차 타입 조합에 편해요. 팀 컨벤션에 맞춰 고르면 돼요.

변환은 모두 브라우저 안에서 이루어져요. 붙여넣은 JSON은 서버로 전송되지 않고, 다음에 이어 쓸 수 있도록 마지막 입력만 이 기기의 브라우저(localStorage)에 남아요.

자주 묻는 질문

JSON을 TypeScript interface로 어떻게 바꾸나요?

입력 칸에 JSON을 붙여넣으면 바로 interface가 만들어져요. 루트 타입 이름, interface·type, export·readonly를 고른 뒤 복사하거나 .ts 파일로 내려받으면 돼요.

interface와 type 중 무엇을 써야 하나요?

객체 모양을 나타낼 때는 둘이 거의 같아요. interface는 같은 이름으로 다시 선언하면 합쳐지고 extends로 확장하기 쉬우며, type은 유니온·교차 타입을 조합하기 좋아요. 최상위가 배열이나 원시값이면 interface로 표현할 수 없어 항상 type으로 만들어요.

선택 필드(?)는 언제 붙나요?

객체 배열에서 어떤 키가 일부 항목에만 있으면 그 키에 ?를 붙여요. 객체가 하나뿐이면 모든 키를 필수로 보니, 선택 필드를 잡고 싶다면 여러 건을 배열로 넣어 주세요.

null 값은 어떤 타입이 되나요?

모든 샘플에서 null이면 null 타입, 다른 값과 섞이면 string | null처럼 합집합이 돼요. null만 있는 필드는 실제 타입을 알 수 없으니 변환한 뒤 직접 고쳐 주세요.

날짜나 정수 타입은 따로 구분하나요?

JSON에는 날짜·정수 타입이 없어서 날짜는 string, 숫자는 모두 number로 만들어요. 필요하면 변환한 뒤 Date나 브랜드 타입으로 바꿔 쓰세요.

입력한 JSON이 서버로 전송되나요?

아니요. 변환은 브라우저 안에서만 이루어지고 어디에도 업로드하지 않아요. 다시 방문했을 때 이어서 쓸 수 있도록 마지막 입력만 이 기기의 localStorage에 저장돼요.

JSON 오류 위치가 표시되지 않아요.

오류 위치는 브라우저가 주는 메시지에서 읽어요. Chrome·Edge·Firefox는 대부분 행·열을 알려 주지만 Safari는 위치를 주지 않아 메시지만 보여요. 흔한 원인은 끝에 남은 쉼표, 작은따옴표, 따옴표 없는 키, 주석이에요.