تحويل JSON إلى TypeScript — توليد الأنواع من JSON

طريقة الاستخدام

1. الصق عينة JSON من استجابة API أو ملف إعدادات.
2. حدّد اسم النوع، مثل Root أو ApiResponse.
3. انسخ الاسم المستعار المُصدَّر للنوع إلى ملف TypeScript.
4. راجع الخصائص التي قد تكون مفقودة أو null في الاستجابات الحقيقية.

قواعد الاستنتاج

تصبح النصوص string، والأعداد number، والقيم المنطقية boolean، وتبقى null كما هي. كل خاصية كائن ظهرت في العينة تكون إلزامية. وتوضع أسماء الخصائص بين علامتي تنصيص، فتبقى الأحرف العربية والصينية والكورية والرموز التعبيرية وعلامات الترقيم مفاتيح صالحة. وتجمع المصفوفات الأشكال المستنتجة المختلفة في اتحاد، بينما تصبح المصفوفات الفارغة unknown[]. ويصبح الكائن الفارغ Record<string, never>.

هذا استنتاج من عينة وليس اكتشافًا للمخطط الكامل، فاستجابة ناجحة واحدة لا تكشف كل استجابات الأخطاء أو الحقول الاختيارية. وترفض الأداة المفاتيح المكررة بدلًا من إهمال القيمة السابقة بصمت. والتعليقات والفواصل الزائدة ليست JSON صالحًا. ويجب أن تتكون أسماء الأنواع من حروف ASCII أو أرقام أو شرطات سفلية أو علامة الدولار، وألا تبدأ برقم، وألا تكون كلمات محجوزة. الحد الأقصى للإدخال مليون حرف، وللاستنتاج 64 مستوى من التداخل.

أمثلة

{"name":"سارة","score":3,"tags":["中文","😀"]} ينتج string للخاصية name، وnumber للخاصية score، وArray للخاصية tags. أما [1,"two",null] فينتج Array<number | string | null>.

الخصوصية

يجري التحويل في متصفحك دون رفع الإدخال أو حفظه. والنتيجة نقطة بداية للتطوير، فقارنها بعقد API الموثّق قبل الاعتماد عليها.