محوّل JSON إلى TypeScript

كيف تُستنتج الأنواع

• الأنواع الأولية: تُربط السلاسل النصية والأعداد والقيم المنطقية بـ string وnumber وboolean.
• الكائنات المتداخلة تصبح واجهات مسمّاة خاصة بها بصيغة PascalCase، فيصبح billing_address بالشكل BillingAddress.
• مصفوفات الكائنات تُدمج في نوع عنصر واحد يُسمّى بصيغة المفرد: users تعطي User[]. والمفتاح المفقود من بعض العناصر يصبح اختياريًا (key?:).
• قيم null تُدمج مع القيم الأخرى المرصودة لذلك المفتاح: string | null. والمفتاح الذي يكون دائمًا null فقط يعود إلى unknown أو any.
• المصفوفات المختلطة تصبح مصفوفات اتحاد مثل (number | string)[].
• الأشكال المتطابقة يُصرَّح عنها مرة واحدة ويُعاد استخدامها، والأشكال المختلفة التي قد تتشارك اسمًا تحصل على لاحقة رقمية.
• المفاتيح التي ليست معرّفات صالحة، مثل "first-name" أو "2fa"، توضع بين علامتي اقتباس.

interface مقابل type

بالنسبة لأشكال الكائنات البسيطة، يكاد الاثنان يكونان قابلين للتبادل. يمكن توسيع تصريحات interface ودمجها، وتعطي أخطاء مترجم أوضح قليلًا. أما أسماء type المستعارة فيمكنها أيضًا التعبير عن الاتحادات والأنواع المعيَّنة (mapped types). تستخدم فرق كثيرة الواجهات لنماذج API والأنواع لكل ما عدا ذلك؛ اختر ما يتوقعه مشروعك أو أداة الفحص لديك (@typescript-eslint/consistent-type-definitions).

احصل على أنواع أفضل من عينتك

لا يمكن أن تكون الأنواع أكمل من العينة. الصق استجابة تتضمن الحقول الاختيارية، أو مصفوفة بعدة عناصر متنوعة، ليتمكن المولّد من اكتشاف المفاتيح الاختيارية والقابلة لـ null. تصل قيم مثل التواريخ والتعدادات كسلاسل نصية عادية في JSON؛ ضيّقها يدويًا بعد ذلك، مثل status: 'active' | 'disabled'. وللتحقق أثناء التشغيل، اجمع الأنواع المُنشأة مع مكتبة مخططات مثل Zod.