تركيب المخططات وتنقيحها
ابنوا مخططات معقدة باستخدام refine وtransform والاتحادات
تركيب المخططات وتنقيحها درس مجاني في TypeScript Academy على CoddyKit. هذا هو الدرس 4 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في TypeScript Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة TypeScript Academy 4 دروس في المجموع.
المخططات قابلة للتركيب
مخططات Zod لبنات بناء قابلة للتركيب. يمكنكم تحسينها وتحويلها وتوسيعها ودمجها لنمذجة قواعد تحقق معقدة.
import { z } from "zod";
const base = z.object({ name: z.string() });
// We will add rules and combine schemas from here.قواعد مخصصة باستخدام refine
تضيف .refine شرط تحقق مخصصًا مع رسالة خطأ، وذلك للقواعد التي لا يوفّر لها Zod دعمًا مدمجًا.
import { z } from "zod";
const password = z.string().refine(
(s) => s.length >= 8,
{ message: "Must be at least 8 characters" }
);
// password.parse("short") throws with that message.تحسين التحقق عبر الحقول
طبّقوا .refine على كائن للتحقق من العلاقات بين الحقول، مثل تطابق تأكيد كلمة المرور.
import { z } from "zod";
const form = z.object({
password: z.string(),
confirm: z.string()
}).refine((d) => d.password === d.confirm, {
message: "Passwords must match"
});
// Validates both fields together.تحويل القيم
تحوّل .transform قيمة جرى التحقق منها إلى بنية أخرى، وتعمل بعد نجاح التحقق.
import { z } from "zod";
const trimmed = z.string().transform((s) => s.trim());
const result = trimmed.parse(" hi "); // "hi"الحقول الاختيارية
تجعل .optional() الحقل قابلًا للغياب، وينعكس ذلك في كل من التحقق والنوع المستنتَج.
import { z } from "zod";
const schema = z.object({
name: z.string(),
bio: z.string().optional()
});
// bio may be omitted.القيم الافتراضية
توفّر .default قيمة عند غياب الإدخال، ولذلك تحتوي النتيجة التي جرى تحليلها دائمًا على قيمة للحقل.
import { z } from "zod";
const schema = z.object({
retries: z.number().default(3)
});
const r = schema.parse({}); // { retries: 3 }مخططات الاتحاد
تقبل z.union قيمة تطابق أي مخطط واحد من عدة مخططات، وهو مكافئ Zod لاتحاد TypeScript.
import { z } from "zod";
const id = z.union([z.string(), z.number()]);
// id.parse("abc") and id.parse(123) both succeed.الاتحادات المميَّزة في Zod
يتحقق z.discriminatedUnion بكفاءة من الاتحادات المعلَّمة، وذلك بالتبديل استنادًا إلى حقل التمييز.
import { z } from "zod";
const shape = z.discriminatedUnion("kind", [
z.object({ kind: z.literal("circle"), radius: z.number() }),
z.object({ kind: z.literal("square"), side: z.number() })
]);
// Picks the right member by kind.الدمج باستخدام extend
تضيف .extend حقولًا إلى مخطط كائن موجود، مما يتيح لكم بناء مخططات أكبر من مخططات أصغر.
import { z } from "zod";
const base = z.object({ id: z.number() });
const user = base.extend({ name: z.string() });
// user validates { id: number; name: string }دمج مخططات الكائنات
يمكنكم أيضًا دمج مخططي كائنات باستخدام .merge، بحيث تُجمع جميع حقولهما في مخطط واحد.
import { z } from "zod";
const a = z.object({ x: z.number() });
const b = z.object({ y: z.string() });
const combined = a.merge(b);
// combined validates { x: number; y: string }ربط كل شيء معًا
تتسلسل التحسينات والتحويلات والقيم الافتراضية والإضافات بسلاسة للتعبير عن عملية تحقق غنية ضمن مخطط واحد سهل القراءة.
import { z } from "zod";
const signup = z.object({
email: z.string().refine(s => s.includes("@"), { message: "Invalid email" }),
age: z.number().default(18)
}).extend({
newsletter: z.boolean().optional()
});
// One schema, many rules.اختبار سريع: تركيب المخططات
اختبروا مدى فهمكم لتركيب المخططات وتحسينها.
مراجعة: تركيب المخططات وتحسينها
تعلّمتم إضافة قواعد مخصصة باستخدام .refine، وإعادة تشكيل القيم باستخدام .transform، والتعامل مع البيانات المفقودة باستخدام .optional و.default، ودمج البدائل باستخدام z.union، وتوسيع المخططات باستخدام .extend و.merge.
import { z } from "zod";
const schema = z.object({ name: z.string() })
.extend({ age: z.number().default(0) })
.refine(d => d.name.length > 0, { message: "Name required" });
// Composed validation in one place.تعلم TypeScript مع معلم ذكاء اصطناعي — مجانًا
اكتب وقم بتشغيل أكوادك الفعلية في المتصفح، واحصل على مساعدة فورية من معلم ذكاء اصطناعي متاح 24/7، واستمر من حيث توقفت على الويب أو في التطبيق.
- الدورات
- 101
- الدروس
- 352
الأسئلة الشائعة
هل درس «تركيب المخططات وتنقيحها» مجاني؟
نعم — نص درس «تركيب المخططات وتنقيحها» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة TypeScript Academy، انتقل إلى CoddyKit PRO. تتضمن دورة TypeScript Academy 4 دروس في المجموع.
ماذا ستتعلم في «تركيب المخططات وتنقيحها»؟
ابنوا مخططات معقدة باستخدام refine وtransform والاتحادات تتمرن على TypeScript Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ TypeScript Academy؟
لا تُشترط خبرة سابقة. TypeScript Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 4 من أصل 4.
كم من الوقت يستغرق درس «تركيب المخططات وتنقيحها»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس TypeScript Academy هذا؟
نعم. كل درس في TypeScript Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- أساسيات مخططات Zod
- استنتاج الأنواع من المخططات
- parse مقابل safeParse
- تركيب المخططات وتنقيحها