محوّل جيسون إلى واجهات TypeScript

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

1. الصق قيمة JSON نموذجية في عينة JSON. تظهر الأنواع أثناء الكتابة.
2. اكتب اسماً تحت اسم الواجهة الجذرية للكائن الخارجي، مثل Product.
3. ألغِ تحديد كتابة export قبل كل تعريف إن بقيت الأنواع في الملف نفسه.
4. انسخ واجهات TypeScript، أو نزّلها ملفاً باسم types.ts.

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

يصبح كل كائن JSON واجهة. ويأتي اسمها من المفتاح الذي يحمله، بصيغة PascalCase: المفتاح first-name يعطي FirstName. وعناصر المصفوفة تأخذ صيغة المفرد لمفتاح المصفوفة، فالمفتاح items يعطي Item. وإن كان الاسم مستخدماً من قبل، يُضاف اسم الأب قبله.

تصبح السلاسل والأعداد والقيم المنطقية string وnumber وboolean. ويُكتب null في الاتحاد، مثل number | null. وتصبح المصفوفة من قيم بنوع متبوعاً بـ []، والمصفوفة الفارغة تصبح unknown[] لأن العينة لا تقول ما فيها.

key "first-name" -> property "first-name": string;   items -> Item[]

عدة عينات في مصفوفة

تُقرأ قائمة الكائنات كشكل واحد. المفتاح الذي يظهر في كل عنصر إلزامي، والمفتاح الغائب من بعض العناصر يُكتب بعلامة استفهام، أي اختياري. والمفتاح الذي يحمل أنواعاً مختلفة في عناصر مختلفة يصبح اتحاداً، مع string أولاً ثم number وboolean والواجهة والمصفوفة وnull.

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

الأسئلة الشائعة