JSON إلى TypeScript
JSON إلى TypeScript
حوّل عينات JSON إلى واجهات TypeScript وtype alias، مع دمج حقول مصفوفات الكائنات تلقائياً، واستنتاج الحقول الاختيارية واتحادات null، وإنشاء تعريفات أنواع مناسبة للمصفوفات والكائنات الفارغة. مناسب لنمذجة استجابات API، وتهيئة الأنواع في الواجهة الأمامية، وتنظيم هياكل البيانات.
بداية سريعة
سيناريوهات شائعة
حوّل استجابات API الحقيقية إلى نماذج TypeScript أولية لواجهات الويب أو عملاء SDK أو اختبارات التكامل.
افحص مصفوفات الكائنات المختلطة لرؤية الحقول الاختيارية وأنواع union قبل تثبيت عقد API.
حوّل بيانات JSON التجريبية إلى تعريفات أنواع سريعة للـ fixtures أو قصص Storybook أو النماذج الأولية.
راجع التصاريح المتداخلة مثل User وMeta عند تغير شكل بيانات الخلفية.
نصائح الاستخدام
القيود والتوافقية
الخصوصية والأمان
أسئلة شائعة
جذور الكائنات تولد تصاريح interface. جذور المصفوفات والقيم البدائية تولد type alias. وعندما تكون الجذور مصفوفة كائنات على المستوى الأعلى، يبقى الجذر type alias مثل type Root = RootItem[]; ويتم تعريف بنية العنصر بشكل منفصل.
من دون عناصر أو خصائص نموذجية، لا يستطيع المولد استنتاج شيء أضيق. لذلك يبقي المصفوفات الفارغة unknown[] والكائنات الفارغة interfaces تمتد من Record<string, unknown> حتى تلصق بيانات أكثر تمثيلاً.
إذا كان الاسم الذي أدخلته معرف TypeScript صالحاً بالفعل، فسيبقى كما هو تماماً، مثل APIResponse. أما الأسماء غير الصالحة فتُحوَّل إلى معرف PascalCase ثابت قبل التوليد.
المولد الحالي يطبع أسماء التصاريح المتداخلة من مسارات الخصائص ويحل التضاربات بشكل حتمي. لذلك يستخدم الإخراج الجديد أسماء مثل User وMeta وFooBarClass بدلاً من إضافة اسم الجذر دائماً كبادئة.
عقد الإخراج الحالي يعيد عمداً تصاريح عادية بلا export. هذا يحافظ على حياد النتيجة، ويمكنك إضافة export بنفسك بما يناسب أسلوب مشروعك.