사용 가이드

JSON 포맷터를 효과적으로 활용하는 방법을 알아보세요

🚀 빠른 시작

1

JSON 데이터 입력

좌측 입력창에 포맷하고 싶은 JSON 데이터를 붙여넣거나 직접 입력하세요.

2

실시간 결과 확인

입력과 동시에 우측에 포맷된 JSON과 TypeScript 인터페이스가 자동으로 생성됩니다.

3

결과 복사

각 영역의 '복사' 버튼을 클릭하여 포맷된 JSON이나 TypeScript 인터페이스를 클립보드에 복사하세요.

💡 주요 기능 상세 설명

1. JSON 포맷팅 및 검증

포맷팅

압축된 JSON을 읽기 쉬운 형태로 정리합니다.

입력 예시:
{"name":"홍길동","age":30,"skills":["JavaScript","TypeScript"]}
출력 예시:
{
  "name": "홍길동",
  "age": 30,
  "skills": [
    "JavaScript",
    "TypeScript"
  ]
}

실시간 검증

JSON 구문 오류를 실시간으로 확인하고 오류 위치를 표시합니다.

  • 누락된 따옴표 감지
  • 잘못된 쉼표 위치 확인
  • 괄호 불일치 검사

2. TypeScript 인터페이스 생성

자동 타입 추론

JSON 구조를 분석하여 적절한 TypeScript 타입을 자동으로 생성합니다.

JSON 입력:
{
  "id": 1,
  "name": "홍길동",
  "active": true,
  "tags": ["개발자", "TypeScript"],
  "profile": {
    "email": "hong@example.com",
    "phone": "010-1234-5678"
  }
}
생성된 인터페이스:
interface MyInterface {
  id: number
  name: string
  active: boolean
  tags: string[]
  profile: {
    email: string
    phone: string
  }
}

인터페이스 이름 커스터마이징

생성될 인터페이스의 이름을 원하는 대로 변경할 수 있습니다.

  • 기본값: "MyInterface"
  • 실시간 이름 변경 가능
  • PascalCase 권장

🔧 실무 활용 예시

API 응답 데이터 타입 정의

백엔드 API에서 받은 응답 데이터를 바탕으로 프론트엔드에서 사용할 TypeScript 인터페이스를 생성합니다.

시나리오:

사용자 정보 API 응답 데이터 처리

// API 응답 JSON
{
  "success": true,
  "data": {
    "user": {
      "id": 123,
      "username": "developer",
      "email": "dev@example.com",
      "profile": {
        "firstName": "개발",
        "lastName": "자",
        "avatar": "https://example.com/avatar.jpg"
      },
      "permissions": ["read", "write"],
      "lastLogin": "2024-01-15T10:30:00Z"
    }
  }
}

생성된 인터페이스를 활용한 TypeScript 코드:

// 생성된 인터페이스 사용
interface ApiResponse {
  success: boolean
  data: {
    user: {
      id: number
      username: string
      email: string
      profile: {
        firstName: string
        lastName: string
        avatar: string
      }
      permissions: string[]
      lastLogin: string
    }
  }
}

// 실제 사용 예시
const fetchUserData = async (): Promise<ApiResponse> => {
  const response = await fetch('/api/user');
  return response.json();
};

설정 파일 구조 분석

복잡한 설정 파일의 구조를 이해하고 TypeScript 타입을 생성합니다.

package.json 구조 분석:

{
  "name": "my-project",
  "version": "1.0.0",
  "scripts": {
    "dev": "next dev",
    "build": "next build"
  },
  "dependencies": {
    "next": "^14.0.0",
    "react": "^18.0.0"
  },
  "devDependencies": {
    "typescript": "^5.0.0",
    "@types/node": "^20.0.0"
  }
}

💡 팁 & 트릭

🎯 효율적인 사용법

  • 키보드 단축키: Ctrl+A로 전체 선택 후 붙여넣기
  • 브라우저 북마크: 자주 사용하는 경우 북마크에 추가
  • 테스트 데이터: 개발 시 샘플 데이터로 활용

🔍 디버깅 팁

  • 오류 메시지 확인: 빨간색 오류 메시지를 자세히 읽어보세요
  • 단계별 검증: 복잡한 JSON은 부분적으로 나누어 검증
  • 따옴표 주의: 문자열은 반드시 큰따옴표 사용

⚡ 성능 최적화

  • 대용량 데이터: 10MB 이하 권장
  • 깊은 중첩: 너무 깊은 객체 구조는 피하세요
  • 배열 처리: 배열의 첫 번째 요소로 타입 추론

⚠️ 주의사항

JSON 형식 규칙

  • 문자열은 큰따옴표(")만 사용
  • 마지막 요소 뒤에 쉼표 없음
  • 주석 사용 불가
  • undefined 값 사용 불가 (null 사용)

개인정보 보호

  • 민감한 정보는 입력하지 마세요
  • API 키나 비밀번호 제거 후 사용
  • 실제 사용자 데이터 대신 더미 데이터 사용