انتقل إلى المحتوى

مخطط JSON إلى TypeScript

حوّل مخطط JSON إلى أنواع TypeScript. تتحول الكائنات إلى واجهات تتضمن خصائص مطلوبة واختيارية، وتتحول $defs والتعريفات إلى صادرات مسماة تشير إليها $ref، كما تتحول enum وconst إلى أنواع حرفية، وanyOf وoneOf إلى اتحادات، وallOf إلى تقاطع. وتُحفظ الأوصاف في تعليقات توثيقية.

إعادة تعيين

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

ما مسودات مخطط JSON المدعومة؟

يقرأ المحوّل الكلمات المفتاحية المشتركة بين draft-07 و2019-09 و2020-12: type وproperties وrequired وadditionalProperties وitems وprefixItems وenum وconst وanyOf وoneOf وallOf و$ref إلى $defs أو definitions. ولا تملك كلمات التحقق مثل minLength أو pattern نظيرًا في TypeScript، لذا تُستبعد.

كيف تُحل مراجع $ref؟

تتحول المراجع إلى # و#/$defs/Name و#/definitions/Name إلى نوع التعريف المسمّى. أما أي مرجع آخر، مثل مرجع إلى ملف آخر أو إلى URL، فيُحدّد نوعه على أنه unknown ويُدرج في تعليق أعلى المخرجات.

كيف تُعالَج additionalProperties؟

يتحول الكائن الذي لا يحتوي على خصائص ويتضمن مخطط additionalProperties إلى Record<string, T>. ويتحول الكائن الذي يحتوي على خصائص ومخطط additionalProperties إلى واجهة مضمومة إلى Record<string, T>. أما additionalProperties false أو غياب الكلمة المفتاحية فلا يضيف شيئًا، لأن أنواع الكائنات TypeScript تصف المفاتيح المعروفة أصلًا.

ما وظيفة nullable؟

تضيف الكلمة المفتاحية nullable: true في OpenAPI 3.0 وامتداد Swagger x-nullable القيمة | null إلى النوع. أما في مخطط JSON نفسه، فاكتب type: ["string", "null"]، لتكون النتيجة string | null.

هل المخططات العودية مدعومة؟

نعم. يصبح التعريف الذي يشير إلى نفسه أو إلى تعريف آخر عبر $ref نوعًا مسمى يشير إلى الاسم الآخر، وتحل TypeScript ذلك دون مشكلات.

هل يتحقق من صلاحية مخططي؟

تقرأ الأداة المخطط فقط. ويتم تجاهل الكلمات المفتاحية غير المعروفة، ويصبح المخطط الذي لا يتضمن type من النوع unknown. استخدم مدقّق مخطط JSON للتحقق من البيانات وفق مخطط.

نبذة عن OneClick Pro

OneClick Pro مجموعة مجانية تضم أكثر من 150 أداة ويب للمهام اليومية: تحويل الصور والوحدات، وتنسيق الأكواد والتحقق من صحتها، وفحص النطاقات وSEO، والعمل مع النصوص والتواريخ والأرقام. تعمل كل أداة دون تسجيل أو اشتراك، ولا تُستخدم البيانات التي تُدخلها إلا لحساب النتيجة ولا تُخزّن مطلقًا. استخدمها كصندوق أدوات سريع للمهام المنفردة، أو أضف الأدوات التي تعتمد عليها يوميًا إلى إشاراتك المرجعية.