مشروع: تحقق Runtime

Runtime Validation Lab

مشروع ~24 دقيقة

مشروع: تحقق Runtime — Runtime Validation Lab

TypeScript لا يعرف حقيقة البيانات القادمة من API أو JSON.parse. لذلك نستخدم unknown ثم نتحقق. type guard هي دالة ترجع value is User، وتخبر TypeScript أن القيمة أصبحت من النوع المطلوب بعد نجاح الفحص.

لا تستخدم as User مباشرة على بيانات خارجية. هذا يخبر compiler أن يثق بك، لكنه لا يفحص شيئاً. الأفضل أن تكتب فحصاً صغيراً للخصائص المهمة.

نموذج type guard

index.ts

type User = {
  id: number;
  name: string;
};

function isUser(value: unknown): value is User {
  if (typeof value !== "object" || value === null) return false;
  // بعد التحقق أعلاه، نعرف أن value كائن غير null.
  // الـ cast إلى Record<string, unknown> آمن هنا لأن كل كائن JavaScript هو Record.
  const candidate = value as Record<string, unknown>;
  return typeof candidate.id === "number" && typeof candidate.name === "string";
}

const data: unknown = { id: 1, name: "Sara" };

if (isUser(data)) {
  console.log(data.name);
} else {
  console.log("invalid user");
}

Output:

هذا الفحص بسيط، لكنه يوضح المبدأ: لا تستخدم البيانات قبل التأكد من شكلها.

تحدي — Challenge

function isString(value: unknown): value is string {
  /* TODO */ return false; // أرجع true إذا كانت value نصاً — Return true if value is a string
}

const value: unknown = "valid";

if (isString(value)) {
  console.log(value);
}