التحقق في وقت التشغيل باستخدام zod (مقدمة)
تحقق من استجابات JSON في وقت التشغيل باستخدام مخططات zod لضمان الأمان بما يتجاوز أنواع وقت الترجمة.
التحقق في وقت التشغيل باستخدام zod (مقدمة) درس مجاني في TypeScript Academy على CoddyKit. هذا هو الدرس 2 من أصل 2. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في TypeScript Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة TypeScript Academy 2 دروس في المجموع.
مقدمة
الهدف: أضف أمانًا أثناء التشغيل باستخدام zod. لا تكفي الأنواع أثناء الترجمة، لذلك تتحقق المخططات من البيانات الفعلية.
تثبيت zod
ثبّت zod، وهي مكتبة شائعة للتحقق من المخططات أثناء التشغيل في TS/JS.
npm install zodتعريف المخطط
أنشئ المخططات باستخدام z.object(). استخدم z.infer<typeof Schema> لإنشاء أنواع TS من المخططات.
import { z } from "zod";
const UserSchema = z.object({
id: z.number(),
name: z.string()
});
type User = z.infer<typeof UserSchema>;Schema.parse()
استدعِ Schema.parse() للتحقق من البيانات. يُطلق خطأً إذا لم تطابق بيانات JSON المخطط.
async function getUser() {
const res = await fetch("/user.json");
const raw = await res.json();
const parsed = UserSchema.parse(raw);
console.log(parsed.id, parsed.name);
}safeParse
تعيد safeParse كائنًا يحتوي على الحقلين success وerror. وهي أكثر أمانًا من إطلاق الاستثناءات.
const result = UserSchema.safeParse(raw);
if (!result.success) {
console.error(result.error);
} else {
console.log(result.data);
}مخطط متداخل
يمكن أن تكون المخططات متداخلة، مثل المصفوفات والكائنات والحقول الاختيارية وغير ذلك.
const PostSchema = z.object({
id: z.number(),
title: z.string(),
tags: z.array(z.string())
});
const raw = { id: 1, title: "Hello", tags: ["ts", "zod"] };
const post = PostSchema.parse(raw);التحقق من التحقق
تحقق سريع: لماذا نستخدم التحقق بواسطة zod بعد تحليل JSON؟
مراجعة
مراجعة: تتحقق مخططات zod من JSON أثناء التشغيل. استخدم parse أو safeParse لضمان الأمان.
الأسئلة الشائعة
هل درس «التحقق في وقت التشغيل باستخدام zod (مقدمة)» مجاني؟
نعم — نص درس «التحقق في وقت التشغيل باستخدام zod (مقدمة)» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة TypeScript Academy، انتقل إلى CoddyKit PRO. تتضمن دورة TypeScript Academy 2 دروس في المجموع.
ماذا ستتعلم في «التحقق في وقت التشغيل باستخدام zod (مقدمة)»؟
تحقق من استجابات JSON في وقت التشغيل باستخدام مخططات zod لضمان الأمان بما يتجاوز أنواع وقت الترجمة. تتمرن على TypeScript Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ TypeScript Academy؟
لا تُشترط خبرة سابقة. TypeScript Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 2 من أصل 2.
كم من الوقت يستغرق درس «التحقق في وقت التشغيل باستخدام zod (مقدمة)»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس TypeScript Academy هذا؟
نعم. كل درس في TypeScript Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- أنواع Fetch API؛ الأنواع العامة لـ Response.json()
- التحقق في وقت التشغيل باستخدام zod (مقدمة)