0Pricing
TypeScript Academy · درس

أنماط قابلة لإعادة الاستخدام لنماذج البيانات

طبّق أنماطًا عامة على نماذج حقيقية: Paginated و Result و DTOs باستخدام Pick/Omit/Partial، وخرائط مفهرسة بالمعرّف.

أنماط قابلة لإعادة الاستخدام لنماذج البيانات درس مجاني في TypeScript Academy على CoddyKit. هذا هو الدرس 3 من أصل 3. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في TypeScript Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة TypeScript Academy 3 دروس في المجموع.

مقدمة

الهدف: تجميع أشكال البيانات الشائعة في أنواع عامة لإعادة استخدام البنية من دون فقدان أمان الأنواع.

  • Paginated<T>
  • Result<T,E>
  • DTOs باستخدام Pick/Omit/Partial
  • خرائط مفهرسة حسب id

Paginated<T>

يجمع Paginated<T> البيانات الوصفية في مكان واحد، ويحافظ على دقة نوع العنصر T في القوائم.

type Paginated<T> = {
  items: T[];
  total: number;
  page: number;
  pageSize: number;
};

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

const page1: Paginated<User> = {
  items: [{ id: 1, name: "Ada" }],
  total: 10,
  page: 1,
  pageSize: 5,
};

console.log(page1.items[0].name);

Result<T,E>

ينمذج Result<T,E> النجاح والفشل بوضوح، باستخدام مميّز (ok) للتفرّع الآمن.

type Ok<T> = { ok: true; data: T };
type Err<E = string> = { ok: false; error: E };

type Result<T, E = string> = Ok<T> | Err<E>;

function readUser(id: number): Result<{ id: number; name: string }> {
  return id > 0 ? { ok: true, data: { id, name: "Ada" } } : { ok: false, error: "not found" };
}

const r = readUser(1);
if (r.ok) {
  console.log(r.data.name);
} else {
  console.error(r.error);
}

أنماط DTO

باستخدام Pick/Omit/Partial، يمكنك اشتقاق أنواع DTO موجزة من النموذج الأساسي، من دون تكرار.

type User = { id: number; name: string; email?: string; role: "user" | "admin" };

type UserCreateDto = Pick<User, "name" | "email">; // fields required to create

// Update = partial editable fields
type UserUpdateDto = Partial<Pick<User, "name" | "email">>;

const createBody: UserCreateDto = { name: "Ada", email: "a@x.io" };
const updateBody: UserUpdateDto = { name: "Ada L." };

MapById<T>

يفهرس MapById<T> الكيانات حسب id لإجراء عمليات بحث سريعة. قيّد T لضمان وجود id.

type Key = string | number;

type MapById<T extends { id: Key }> = Record<Key, T>;

const byId: MapById<{ id: number; name: string }> = {
  1: { id: 1, name: "Ada" },
  2: { id: 2, name: "Lin" },
};

console.log(byId[1].name);

نصائح

نصائح:

  • حافظ على أنماط صغيرة قابلة للتركيب.
  • فضّل الاتحادات المميّزة لآلات الحالات.
  • اشتق أنواع DTO من النماذج، وتجنب النسخ اليدوي.

فحص Paginated<T>

فحص سريع: لماذا نعرّف نوعاً عاماً هو Paginated<T>؟

خلاصة

خلاصة: عمّم الأشكال المتكررة: Paginated<T> وResult<T,E> وأنواع DTO باستخدام Pick/Omit/Partial والخرائط المفهرسة حسب id. تتوسع المساعدات الصغيرة عبر الميزات المختلفة.

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

هل درس «أنماط قابلة لإعادة الاستخدام لنماذج البيانات» مجاني؟

نعم — نص درس «أنماط قابلة لإعادة الاستخدام لنماذج البيانات» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة TypeScript Academy، انتقل إلى CoddyKit PRO. تتضمن دورة TypeScript Academy 3 دروس في المجموع.

ماذا ستتعلم في «أنماط قابلة لإعادة الاستخدام لنماذج البيانات»؟

طبّق أنماطًا عامة على نماذج حقيقية: Paginated و Result و DTOs باستخدام Pick/Omit/Partial، وخرائط مفهرسة بالمعرّف. تتمرن على TypeScript Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ TypeScript Academy؟

لا تُشترط خبرة سابقة. TypeScript Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 3 من أصل 3.

كم من الوقت يستغرق درس «أنماط قابلة لإعادة الاستخدام لنماذج البيانات»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس TypeScript Academy هذا؟

نعم. كل درس في TypeScript Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

  1. الواجهات العامة والأسماء المستعارة العامة للأنواع
  2. الأنواع الشرطية (مقدمة) والتوزيع على الاتحادات
  3. أنماط قابلة لإعادة الاستخدام لنماذج البيانات
← العودة إلى TypeScript Academy