JSON إلى TypeScript
حوّل عينة JSON إلى واجهات أو أسماء مستعارة للأنواع في TypeScript. تصبح الكائنات المتداخلة أنواعًا مسماة مستقلة، وتُدمج مصفوفات الكائنات بحيث تصبح المفاتيح الغائبة عن بعض العناصر اختيارية، وتتحول القيم المختلطة إلى أنواع اتحاد. الصق استجابة API، واختر واجهة أو نوعًا، ثم انسخ التصريحات الجاهزة لإضافتها مباشرة إلى الكود.
الأسئلة الشائعة
كيف تُعالَج الكائنات المتداخلة؟
يحصل كل كائن متداخل على تصريح خاص به، ويُسمّى نسبةً إلى المفتاح الذي يحتويه بصيغة PascalCase؛ فمثلًا يصبح address هو Address. وتُسمّى الكائنات داخل المصفوفات بصيغة المفرد من مفتاح المصفوفة، لذا يصبح users هو User وcategories هي Category. أما الكائنات التي تتطابق حقولها تمامًا فتشترك في تصريح واحد.
متى تصبح الخاصية اختيارية؟
عندما تحتوي المصفوفة على عدة كائنات ويغيب مفتاح عن بعضها، يُعلَّم ذلك المفتاح على أنه اختياري بعلامة استفهام. وتظل المفاتيح الموجودة في كل عنصر مطلوبة. أما الكائن المفرد فلا توجد عينات أخرى لمقارنته بها، لذا تكون كل مفاتيحه مطلوبة.
كيف تُحدَّد أنواع القيم null؟
يُحدَّد نوع المفتاح الذي تكون قيمته null في عينتك على أنه null، وإذا كانت قيمته null في بعض العناصر وسلسلة نصية في عناصر أخرى يصبح نوعه string | null. إذا كان من الممكن أن تكون قيمة حقل ما null في البيانات الفعلية لكنها ليست كذلك في عينتك، فأضف null يدويًا أو الصق عينة تتضمنها.
هل أختار interface أم type؟
كلاهما يصف البنية نفسها. يمكن توسيع الواجهات ودمجها، وهو ما تفضّله أدلة الأنماط غالبًا لبنى الكائنات؛ كما تعمل الأسماء المستعارة للأنواع مع الاتحادات، وتستخدمها بعض الفرق في كل الحالات. اختر ما يستخدمه أساس الكود لديك؛ فالحقول متطابقة.
كيف تُحدَّد أنواع المصفوفات؟
تتحول المصفوفة التي تحتوي على نوع واحد من القيم إلى ذلك النوع مع [] بعده، مثل string[] أو User[]. أما المصفوفة التي تضم أنواعًا متعددة فتتحول إلى اتحاد بين أقواس، مثل (string | number)[]. وتتحول المصفوفة الفارغة إلى unknown[] لأن العينة لا تقدم معلومات عن عناصرها.
ماذا يحدث للمفاتيح التي لا تُعدّ معرّفات صالحة؟
تُكتب المفاتيح التي تحتوي على مسافات أو شرطات أو أحرف أخرى غير مسموح بها في معرّف TypeScript بين علامتي اقتباس؛ مثل "first-name": string، وهي صيغة صالحة في TypeScript وتطابق JSON تمامًا.
هل تُحدَّد الأعداد على أنها أعداد صحيحة أم عشرية؟
لدى TypeScript نوع واحد للأعداد، لذا تتحول الأعداد الصحيحة والعشرية إلى number. إذا أردت معرفة القيم الصحيحة، فإن منشئ مخططات JSON يميّز بين integer وnumber.
هل يمكنني إعادة تسمية النوع الجذري؟
نعم. أدخل اسمًا للنوع الجذري، مثل ApiResponse. سيُحوَّل الاسم إلى PascalCase، بينما تحتفظ الأنواع المتداخلة بالأسماء المستمدة من مفاتيحها. عندما يكون المستوى الأعلى من JSON مصفوفة أو قيمة مفردة، يصبح النوع الجذري اسمًا مستعارًا لذلك النوع.
هل يجري التعرّف على التواريخ؟
لا. لا يتضمن JSON نوعًا للتاريخ، لذا يُعدّ التاريخ في عينتك سلسلة نصية ويُحدَّد نوعه على أنه string. حوّله إلى Date في الكود بعد التحليل، أو ضيّق النوع يدويًا إذا كنت تستخدم نوعًا بصيغة قالبية.
ما الحد الأقصى لحجم JSON؟
حتى 1,000,000 حرفًا، مع إمكانية التداخل حتى عمق 64 مستوى. لا تُخزَّن العينة؛ إذ يُكتفى بتحليلها لإنشاء الأنواع.