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

JSON إلى Zod

أنشئ مخططات Zod من عينة JSON. تصبح الكائنات المتداخلة مخططات مُصدّرة مستقلة، وتتحول المفاتيح الغائبة عن بعض عناصر المصفوفة إلى .optional()، والقيم null إلى .nullable()، والقيم المختلطة إلى z.union. يحصل كل مخطط أيضًا على اسم مستعار للنوع z.infer، لتجمع بين التحقق وقت التشغيل والأنواع TypeScript من عملية لصق واحدة.

إعادة تعيين

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

كيف تُسمّى الكائنات المتداخلة؟

يصبح كل كائن متداخل نوع Zod مستقلًا، وتُشتق تسميته من المفتاح الذي يحتويه بصيغة PascalCase، فيصبح address مثلًا Address. أما الكائنات داخل المصفوفات فتأخذ صيغة المفرد من اسم مفتاح المصفوفة، فيصبح users مثلًا User. وتتشارك الكائنات التي لها الحقول نفسها تمامًا نوعًا واحدًا.

متى يكون الحقل اختياريًا؟

عندما تحتوي المصفوفة على عدة كائنات ويغيب مفتاح عن بعضها، يصبح ذلك الحقل اختياريًا: يضيف المخطط .optional(). يكون المفتاح الموجود في كل العينات مطلوبًا. أما الكائن المنفرد فلا يوجد ما يقارنه به، لذا تكون كل مفاتيحه مطلوبة.

كيف تُعالَج القيم null؟

إذا كانت قيمة المفتاح null في بعض العينات وله قيمة في عينات أخرى، يصبح النوع متبوعًا بـ .nullable(). أما المفتاح الذي تكون قيمته null دائمًا فلا يوفر للأداة معلومات عن نوعه الحقيقي، لذا يصبح z.null()؛ ألصق عينة تتضمن قيمة فعلية للحصول على نوع دقيق.

ما أنواع الأرقام المستخدمة؟

تصبح الأعداد الصحيحة z.number().int()، وتصبح الأعداد الكسرية z.number(). وإذا احتوى الحقل نفسه على النوعين، يستخدم المخطط z.number()، لأن كل عدد صحيح هو أيضًا عدد صالح.

ماذا يحدث للمفاتيح التي ليست أسماء صالحة؟

تُكتب المفاتيح التي ليست معرّفات JavaScript صالحة، مثل first-name، بين علامتي اقتباس في z.object، كي يطابق المخطط مفاتيح JSON الأصلية تمامًا.

هل يتم تحميل JSON الخاص بي أو تخزينه؟

يُرسل JSON إلى الخادم فقط لإنشاء الرمز لهذا الطلب، ولا يُخزّن. لا يقرأ المولّد سوى بنية عينتك وأنواع قيمها، لذا يمكنك استبدال القيم الحساسة بعناصر نائبة من النوع نفسه قبل لصقها.

نبذة عن OneClick Pro

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