توليد واجهات TypeScript تلقائياً من استجابات JSON

مولِّد أنواع JSON → TypeScript يفحص عيِّنة من JSON ويستنتج تلقائياً تعريفات interface أو type بلغة TypeScript. وهو يُريح مهندسي الواجهة الأمامية من كتابة تعريفات الأنواع المتكررة يدوياً عند التكامل مع واجهات API الخلفية. تُقسَّم الكائنات المتداخلة إلى أنواع مستقلة، وتُدمج عناصر المصفوفات، وتُلغى ازدواجية أشكال الكائنات المجهولة المتطابقة وتُعاد استخدامها.

الخطوة 1 — الصق استجابة JSON واقعية في اللوحة اليسرى أو انقر "Sample" لتحميل مثال. الخطوة 2 — أدخل اسم النوع الجذري (الافتراضي: RootObject). الخطوة 3 — اختر نمط الإخراج: interface أنسب لتعريفات الكائنات القابلة للتوسيع، بينما type أكثر مرونة ويتناسق جيداً مع أنواع الاتحاد. الخطوة 4 — تُنتج اللوحة اليمنى كود الأنواع الكامل في الوقت الفعلي؛ انسخه إلى مشروعك أو نزِّله كملف types.ts. تحتوي كل الأنواع المولَّدة على كلمة export بحيث تكون جاهزة للاستخدام مباشرة.

توليد أنواع TS من عيِّنات استجابات Swagger أو Postman أثناء تكامل الواجهتين الأمامية والخلفية؛ الحصول على بيانات نموذجية من توثيق واجهات API خارجية وبناء مكتبة أنواع بسرعة؛ إضافة أنواع لحمولات BaaS مثل Firebase أو Supabase؛ بناء واجهات Options من عيِّنات الإعدادات عند تطوير مكتبات الأدوات؛ استيراد الأنواع بالجملة عند ترحيل مشروع JavaScript قديم إلى TypeScript.

تُستنتج الأنواع الأولية على أنها string أو number أو boolean أو null. تصبح المصفوفات الفارغة any[]، أما المصفوفات ذات الأنواع المختلطة فتُنتج نوع اتحاد. تُوضع أسماء الحقول التي ليست معرِّفات JS صالحة بين علامات اقتباس. تُشتَق أسماء الأنواع للكائنات المتداخلة من مفتاح الأب بصيغة PascalCase. تُنتج الكائنات ذات الشكل نفسه تعريفاً واحداً فقط. لا تتضمن الأنواع المولَّدة معدِّل الاختيارية (?)؛ عدِّلها يدوياً إذا احتجت حقولاً اختيارية.

يُجرى استنتاج الأنواع بالكامل في متصفحك. لا يُرفع JSON الذي تقدمه أبداً، فيمكنك استخدامه بأمان مع استجابات API الإنتاجية.