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

مخطط 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() وتُدرج في تعليق أعلى المخرجات.

نبذة عن OneClick Pro

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