مخطط JSON إلى Zod
حوّل مخطط JSON إلى مخططات Zod. تُحوّل الأنواع والخصائص المطلوبة وenum وconst وanyOf وoneOf وallOf إلى منشئات Zod، وتتحول كلمات التحقق الشائعة مثل minLength وmaximum وpattern وformat وminItems إلى فحوصات Zod. ويتحول كل تعريف إلى مخطط مُصدّر بنوع z.infer.
الأسئلة الشائعة
ما كلمات التحقق التي يجري تحويلها؟
تتحول minLength وmaxLength إلى .min() و.max() على النصوص، وتتحول pattern إلى .regex()، كما تتحول التنسيقات email وuri وuuid وdate-time إلى .email() و.url() و.uuid() و.datetime(). وتتحول minimum وmaximum وexclusiveMinimum وexclusiveMaximum وmultipleOf إلى فحوصات للأعداد، بينما تتحول minItems وmaxItems إلى فحوصات للمصفوفات.
كيف تُرتب التعريفات؟
يُصرّح بكل تعريف قبل المخططات التي تستخدمه. ويُشار إلى التعريف الذي يعود إلى نفسه مباشرة أو عبر تعريفات أخرى باستخدام z.lazy، كي يستمر تشغيل الكود.
هل تجتاز المخططات العودية فحص الأنواع؟
تعمل، لكن لا يستطيع TypeScript استنتاج نوع مخطط يشير إلى نفسه عبر z.lazy. أضف تصريحًا صريحًا بالنوع إلى هذا المخطط، كما يوضح توثيق Zod للأنواع العودية.
كيف تُعالَج additionalProperties؟
تضيف additionalProperties false .strict()، ويضيف المخطط .catchall() مع ذلك المخطط، بينما تضيف true .passthrough(). ويتحول الكائن الذي لا يتضمن خصائص لكنه يحتوي على مخطط additionalProperties إلى z.record(z.string(), ...).
ما إصدار Zod الذي يستهدفه الكود؟
توجد أدوات الإنشاء المُولَّدة، مثل z.object وz.union وz.record مع مخطط مفتاح وnullable()، في Zod 3 وZod 4. ولا يزال Zod 4 يقبل أساليب تنسيق السلاسل مثل email()، كما يوفّر z.email() كصيغة أقصر.
ماذا يحدث للمراجع التي لا تستطيع الأداة حلها؟
تتحول المراجع خارج المستند، مثل مرجع إلى ملف آخر أو إلى URL، إلى z.unknown() وتُدرج في تعليق أعلى المخرجات.