JSON to TypeScript

JSON से TypeScript रूपांतरण क्या है?

JSON पेलोड चिपकाएँ और TypeScript इंटरफ़ेस पाएं — ऐसे typed contracts जो ठीक-ठीक बताते हैं कि किसी ऑब्जेक्ट में कौन-से गुण हैं और प्रत्येक गुण का प्रकार क्या है। इनके बिना, JSON.parse() से आया डेटा any के रूप में आता है, जिससे एडिटर में कोई सहायता नहीं मिलती और प्रॉपर्टी एक्सेस या असाइनमेंट पर कंपाइलर कोई जाँच नहीं करता। JSON को TypeScript में बदलने से यह सुरक्षा मिलती है — बिना इंटरफ़ेस हाथ से लिखे।

TypeScript JSON के सभी छह मान प्रकारों को कवर करता है: स्ट्रिंग, संख्या, बूलियन, null, ऑब्जेक्ट और ऐरे। प्रत्येक नेस्टेड JSON ऑब्जेक्ट अपने नाम वाले इंटरफ़ेस में बदल जाता है। ऐरे का प्रकार पहले तत्व से अनुमानित होता है। परिणाम वही होता है जो JSON.parse() रनटाइम पर वास्तव में लौटाता है, इसलिए इंटरफ़ेस अनुमान पर नहीं बल्कि वास्तविक डेटा पर आधारित होते हैं।

बड़े या गहरे नेस्टेड JSON के लिए इंटरफ़ेस हाथ से लिखना थकाऊ और त्रुटि-प्रवण होता है। JSON to TypeScript जनरेटर संरचना को स्वतः पढ़ता है, नेस्टिंग को रिकर्सिव तरीके से संभालता है और कुछ सेकंड में साफ़ इंटरफ़ेस कोड जनरेट करता है। यह विशेष रूप से तब उपयोगी होता है जब किसी अपरिचित API से जोड़ रहे हों, mock डेटा के साथ प्रोटोटाइप बना रहे हों, या JavaScript कोडबेस को TypeScript में migrate कर रहे हों। यह नेस्टेड प्रॉपर्टी के नाम और प्रकार हाथ से ट्रैक करने की ज़िम्मेदारी से भी मुक्त करता है, ताकि आप टाइप बॉयलरप्लेट के बजाय एप्लिकेशन लॉजिक पर ध्यान दे सकें।

JSON to TypeScript जनरेटर का उपयोग क्यों करें?

छोटे ऑब्जेक्ट के लिए TypeScript इंटरफ़ेस हाथ से बनाना व्यावहारिक है, लेकिन नेस्टेड संरचनाओं या बड़ी API प्रतिक्रियाओं के साथ यह जल्दी जटिल हो जाता है। तीन स्तर की नेस्टिंग वाली 50-फ़ील्ड API प्रतिक्रिया पर विचार करें — उसे हाथ से लिखने का अर्थ है दर्जनों इंटरफ़ेस, जिनमें से प्रत्येक में टाइपो या छूटे nullable फ़ील्ड की संभावना है। ऑटोमैटिक जनरेटर पूरा सेट कुछ ही मिलीसेकंड में तैयार करता है और आपके कोड तथा उपभोग किए जाने वाले डेटा के बीच प्रकार-असंगति की संभावना कम करता है। सटीकता से परे, यह आपके टाइप को वास्तविक API contract के अनुरूप भी रखता है। जब कोई सेवा अपना response format बदलती है, तो बस अद्यतन JSON चिपकाएँ और फिर जनरेट करें — हस्तलिखित इंटरफ़ेस फ़ाइल में बदली हुई हर प्रॉपर्टी ढूँढने से कहीं तेज़।

JSON to TypeScript के उपयोग के मामले

JSON से TypeScript प्रकार मैपिंग संदर्भ

प्रत्येक JSON मान एक TypeScript प्रकार से संगत होता है। नीचे दी गई तालिका दर्शाती है कि प्रत्येक JSON primitive और structural type कैसे translate होता है। यह मैपिंग ECMA-404 JSON standard और TypeScript के built-in types का अनुसरण करती है।

TypeScript interface बनाम type Alias

TypeScript ऑब्जेक्ट format describe करने के दो तरीके देता है: interface declarations और type aliases। दोनों JSON संरचनाओं को दर्शाने के लिए उपयुक्त हैं, लेकिन extension और merging behavior में भिन्न हैं। अधिकांश JSON-to-TypeScript जनरेटर interface आउटपुट करते हैं क्योंकि TypeScript में ऑब्जेक्ट format के लिए यही standard choice है।

कोड उदाहरण

नीचे विभिन्न भाषाओं और tools में JSON से TypeScript इंटरफ़ेस जनरेट करने के उदाहरण दिए गए हैं। प्रत्येक snippet चलाने योग्य आउटपुट जनरेट करता है।

// Manual interface definition from a JSON shape
const json = '{"id": 1, "name": "Alice", "active": true}';
const parsed = JSON.parse(json);

interface User {
  id: number;
  name: string;
  active: boolean;
}

const user: User = parsed;
console.log(user.name); // "Alice" — fully typed

import JsonToTS from 'json-to-ts';

const json = {
  id: 1,
  name: "Alice",
  address: { street: "123 Main St", city: "Springfield" },
  tags: ["admin", "user"]
};

const interfaces = JsonToTS(json, { rootName: "User" });
console.log(interfaces.join("\n\n"));
// interface Address {
//   street: string;
//   city: string;
// }
//
// interface User {
//   id: number;
//   name: string;
//   address: Address;
//   tags: string[];
// }

# Install: pip install datamodel-code-generator
# Generate TypeScript-style types from JSON using Pydantic models

# Command line:
# datamodel-codegen --input data.json --output model.py

# Or generate TypeScript directly with quicktype:
# pip install quicktype
# quicktype --lang ts --src data.json --out types.ts

import json

data = {"id": 1, "name": "Alice", "scores": [98, 85, 92]}

# Python equivalent using TypedDict (Python 3.8+)
from typing import TypedDict, List

class User(TypedDict):
    id: int
    name: str
    scores: List[int]

user: User = data  # type-checked by mypy

# Install quicktype globally
npm install -g quicktype

# Generate TypeScript interfaces from a JSON file
quicktype --lang ts --src data.json --out types.ts

# From a JSON string via stdin
echo '{"id": 1, "name": "Alice"}' | quicktype --lang ts

# Output:
# export interface Root {
#   id:   number;
#   name: string;
# }

अक्सर पूछे जाने वाले प्रश्न