لا تحب الإعلانات؟ يذهب خالية من الإعلانات اليوم 

مولد مخطط Zod من JSON

مطورالرياضيات

إعلان · حذف؟

مدخل

عملية تلقائية

انتاج

جانب العميل

إعلان · حذف؟

مرشد

مولد مخطط Zod من JSON

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

كيفية استخدام

الصق بيانات JSON الخاصة بك في منطقة الإدخال أو انقر فوق الزر "عينة" لتحميل بيانات مثال. تقوم الأداة بإنشاء مخطط Zod المقابل على الفور. قم بالتبديل بين مخرجات TypeScript وجافاسكريبت العادية. قم بتمكين الوضع الصارم للأشكال الكائنية الدقيقة أو وضع المرور للسماح بالمفاتيح غير المعروفة. اختياريًا، أضف سطر تصدير استدلال النوع. قم بتخصيص اسم متغير المخطط وانسخ المخرجات إلى الحافظة الخاصة بك.

خصائص

استدلال النوع العودي – يتعامل مع الكائنات المتداخلة، والمصفوفات، والأنواع المختلطة مع z.union()، وجميع الأنواع الأولية
كشف نمط السلسلة – يكشف تلقائيًا عن تواريخ ISO، ومعرفات UUID، ورسائل البريد الإلكتروني، وعناوين URL، وعناوين IP ويطبق مدققات Zod المطابقة
كشف التعداد – عندما يحتوي حقل السلسلة على أقل من 6 قيم فريدة عبر عناصر المصفوفة، يقترح z.enum() بدلاً من z.string()
اكتشاف الحقول الاختيارية – يتم تمييز الحقول غير الموجودة في جميع عناصر المصفوفة تلقائيًا بأنها .optional()
صارم مقابل المرور – التبديل بين .strict() للأشكال الدقيقة أو .passthrough() للسماح بالمفاتيح غير المعروفة
إخراج TypeScript – التبديل بين TypeScript وجافاسكريبت العادية مع تصدير نوع z.infer اختياري
الإنشاء في الوقت الفعلي – يتم تحديث المخطط على الفور أثناء الكتابة أو لصق JSON
نسخ إلى الحافظة – نسخ رمز المخطط المُنشأ بنقرة واحدة

إعلان · حذف؟

 التعليمات

ما هو Zod ولماذا يجب أن أستخدمه؟

Zod هي مكتبة للتحقق من المخطط تركز على TypeScript تتيح لك تحديد أشكال البيانات والتحقق منها في وقت التشغيل. على عكس أنواع TypeScript التي توجد فقط في وقت التصريف ويتم مسحها في الإنتاج، تتحقق مخططات Zod من البيانات الفعلية التي تتدفق عبر تطبيقك. هذا يلتقط استجابات واجهة برمجة التطبيقات المشوهة، ومدخلات النماذج غير الصالحة، وأشكال البيانات غير المتوقعة قبل أن تسبب أخطاء. يتكامل Zod جيدًا مع React Hook Form و tRPC وإجراءات خادم Next.js، مما يجعله أكثر مكتبات التحقق في وقت التشغيل شيوعًا في نظام TypeScript البيئي.
كيف تكتشف الأداة أنماط السلسلة مثل التواريخ ورسائل البريد الإلكتروني؟

تستخدم الأداة التعبيرات العادية لمطابقة أنماط السلاسل الشائعة في قيم JSON الخاصة بك. يتم اكتشاف سلاسل تاريخ ISO 8601 مثل 2024-01-15T10:30:00Z وتعيينها إلى z.string().datetime(). يتم تعيين سلاسل UUID v4 إلى z.string().uuid(). تحصل عناوين البريد الإلكتروني على z.string().email()، وعناوين URL على z.string().url()، وعناوين IP على z.string().ip(). هذا يعني أن المخطط المُنشأ الخاص بك يتضمن التحقق المضمن لهذه التنسيقات الشائعة بدلاً من مجرد z.string()، مما يمنحك دقة أكبر في سلامة النوع والتحقق من الصحة فورًا.
ما هو الفرق بين الوضع الصارم ووضع المرور؟

في الوضع الصارم، يستخدم المخطط المُنشأ z.object().strict()، مما يعني أن أي خصائص غير محددة في المخطط ستؤدي إلى فشل التحقق. هذا مفيد عندما تريد التأكد من عدم مرور أي بيانات إضافية. يستخدم وضع المرور z.object().passthrough()، والذي يسمح للخصائص غير المعروفة بالمرور دون تحقق. استخدم الوضع الصارم للبيانات الحساسة للأمان مثل مدخلات واجهة برمجة التطبيقات. استخدم وضع المرور عندما تهتم فقط بحقول معينة وتريد تجاهل الباقي، مثل عند استهلاك واجهة برمجة تطبيقات لطرف ثالث قد تضيف حقولًا جديدة.
كيف يعمل اكتشاف الحقول الاختيارية مع مصفوفات الكائنات؟

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