JSON থেকে TypeScript

JSON থেকে TypeScript রূপান্তর কী?

একটি JSON পেলোড পেস্ট করুন এবং বিনিময়ে TypeScript ইন্টারফেস পাবেন — টাইপড চুক্তি যা একটি অবজেক্টের ঠিক কোন প্রপার্টি আছে এবং প্রতিটি কী ধরনের, তা সুনির্দিষ্টভাবে বর্ণনা করে। এগুলো ছাড়া JSON.parse() থেকে আসা ডেটা any হিসেবে আসে, এডিটর অটোকমপ্লিট বা কম্পাইলার চেক কিছুই পাওয়া যায় না। JSON থেকে TypeScript রূপান্তর হাতে ইন্টারফেস না লিখেই সেই নিরাপত্তা দেয়।

TypeScript সব ছয়টি JSON মানের ধরন কভার করে: string, number, boolean, null, object এবং array। প্রতিটি নেস্টেড JSON অবজেক্ট তার নিজস্ব নামযুক্ত ইন্টারফেসে পরিণত হয়। অ্যারেগুলো প্রথম উপাদান থেকে টাইপ পায়। ফলাফল রানটাইমে JSON.parse() আসলে যা রিটার্ন করে তার সাথে মিলে যায়, তাই ইন্টারফেসগুলো অনুমানের পরিবর্তে বাস্তব ডেটা প্রতিফলিত করে।

বড় বা গভীরভাবে নেস্টেড JSON-এর জন্য হাতে ইন্টারফেস লেখা ক্লান্তিকর এবং ত্রুটিপ্রবণ। একটি JSON থেকে TypeScript জেনারেটর স্বয়ংক্রিয়ভাবে কাঠামো পড়ে, রিকার্সিভলি নেস্টিং সামলায় এবং কয়েক সেকেন্ডে পরিষ্কার ইন্টারফেস কোড আউটপুট করে। অপরিচিত API সংযুক্ত করার সময়, মক ডেটা দিয়ে প্রোটোটাইপ করার সময়, অথবা JavaScript কোডবেস TypeScript-এ মাইগ্রেট করার সময় এটি বিশেষভাবে কার্যকর। এটি নেস্টেড প্রপার্টির নাম ও ধরন হাতে ট্র্যাক করার ঝামেলা থেকেও মুক্তি দেয়, যাতে আপনি টাইপ বয়লারপ্লেটের পরিবর্তে অ্যাপ্লিকেশন লজিকে মনোযোগ দিতে পারেন।

JSON থেকে TypeScript জেনারেটর কেন ব্যবহার করবেন?

হাতে TypeScript ইন্টারফেস তৈরি করা ছোট অবজেক্টের জন্য বাস্তবসম্মত, কিন্তু নেস্টেড কাঠামো বা বড় API রেসপন্সের সাথে দ্রুত জটিল হয়ে পড়ে। তিন স্তরের নেস্টিং সহ একটি ৫০-ফিল্ডের API রেসপন্স বিবেচনা করুন — সেটি হাতে লিখতে ডজনখানেক ইন্টারফেস লাগে, প্রতিটি টাইপো বা মিস হওয়া nullable ফিল্ডের সম্ভাব্য উৎস। একটি স্বয়ংক্রিয় জেনারেটর মিলিসেকেন্ডে পূর্ণ সেট তৈরি করে এবং আপনার কোড ও তা যে ডেটা ব্যবহার করে তার মধ্যে টাইপ অমিলের সম্ভাবনা কমায়। নির্ভুলতার বাইরে, এটি আপনার টাইপগুলো প্রকৃত API চুক্তির সাথে সামঞ্জস্যপূর্ণ রাখে। কোনো সার্ভিস তার রেসপন্স কাঠামো পরিবর্তন করলে, কেবল আপডেট করা JSON পেস্ট করুন এবং পুনরায় জেনারেট করুন — হাতে লেখা ইন্টারফেস ফাইলে প্রতিটি পরিবর্তিত প্রপার্টি খুঁজে বের করার চেয়ে অনেক দ্রুত।

JSON থেকে TypeScript ব্যবহারের ক্ষেত্র

JSON থেকে TypeScript টাইপ ম্যাপিং রেফারেন্স

প্রতিটি JSON মান একটি TypeScript টাইপে ম্যাপ হয়। নীচের সারণী দেখায় প্রতিটি JSON প্রিমিটিভ ও কাঠামোগত টাইপ কীভাবে অনুবাদ হয়। এই ম্যাপিং ECMA-404 JSON মান এবং TypeScript-এর অন্তর্নির্মিত টাইপ অনুসরণ করে।

TypeScript interface বনাম type অ্যালিয়াস

TypeScript অবজেক্টের আকার বর্ণনা করতে দুটি উপায় অফার করে: interface ডিক্লারেশন এবং type অ্যালিয়াস। উভয়ই JSON কাঠামো উপস্থাপনের জন্য কাজ করে, তবে এক্সটেনশন ও মার্জিং আচরণে পার্থক্য রয়েছে। বেশিরভাগ JSON-থেকে-TypeScript জেনারেটর interface আউটপুট করে কারণ TypeScript-এ অবজেক্টের আকারের জন্য এটি প্রচলিত পছন্দ।

কোড উদাহরণ

নীচে বিভিন্ন ভাষা ও টুলে JSON থেকে TypeScript ইন্টারফেস জেনারেট করার উদাহরণ রয়েছে। প্রতিটি স্নিপেট চালানোযোগ্য আউটপুট তৈরি করে।

// 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;
# }

সাধারণ জিজ্ঞাসা