0Pricing
TypeScript Academy · درس

‏Record: ربط المفاتيح بأنواع القيم

أنشئوا أنواعًا شبيهة بالقواميس باستخدام Record

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

مرحبًا

ينشئ Record نوع كائن بمفاتيح محددة K ونوع قيمة موحّد V. ويغنيك عن كتابة كل مفتاح يدويًا في البنى الشبيهة بالقواميس.

صيغة Record الأساسية

مرّر نوع المفتاح ونوع القيمة إلى Record.
type Roles = Record<'admin' | 'user' | 'guest', boolean>;
const access: Roles = { admin: true, user: true, guest: false };

Record مع مفاتيح من نوع string

استخدم `string` نوعًا للمفتاح لإنشاء قاموس عام.
const headers: Record<string, string> = {
  'content-type': 'application/json',
  'authorization': 'Bearer token'
};

استخدام Record لجداول البحث

يُعد Record مناسبًا لجداول البحث التي تربط المعرّفات أو الرموز بالقيم.
const statusLabels: Record<number, string> = {
  200: 'OK',
  404: 'Not Found',
  500: 'Server Error'
};

كيفية تنفيذ Record

Record هو نوع مُعيَّن على اتحاد المفاتيح.
type Record<K extends string | number | symbol, V> = { [P in K]: V };

Record مقابل توقيع الفهرس

إن `Record` مكافئ لـ `{ [key: string]: V }`، لكنه أوضح وأسهل في الدمج.
// Equivalent:
type A = Record<string, number>;
type B = { [key: string]: number };

Record مع قيم الاتحاد

يمكن أن يكون نوع القيمة اتحادًا أو نوعًا معقدًا.
type Config = Record<'development' | 'staging' | 'production', { url: string; debug: boolean }>;

Record جزئي

ادمجه مع Partial للسماح بعدم وجود جميع المفاتيح.
type OptionalConfig = Partial<Record<'debug' | 'verbose' | 'trace', boolean>>;

Record للقراءة فقط

ادمجه مع Readonly لمنع التغييرات.
const CODES: Readonly<Record<string, number>> = { A: 1, B: 2 };

استخدام Record للتجميع

استخدم Record لتجميع العناصر حسب مفتاح الفئة.
function groupBy<T>(items: T[], key: keyof T): Record<string, T[]> {
  return items.reduce((acc, item) => {
    const k = String(item[key]);
    (acc[k] ??= []).push(item);
    return acc;
  }, {} as Record<string, T[]>);
}

Record مع مفاتيح التعداد

يمكن استخدام قيم Enum مفاتيحَ لـ Record.
enum Color { Red = 'RED', Green = 'GREEN', Blue = 'BLUE' }
const hexCodes: Record<Color, string> = {
  [Color.Red]: '#FF0000',
  [Color.Green]: '#00FF00',
  [Color.Blue]: '#0000FF',
};

تحقق سريع

ماذا ينتج `Record<'a' | 'b', number>`؟

مراجعة

ينشئ Record قاموسًا محدد الأنواع بمفاتيح معينة وأنواع قيم موحّدة. استخدمه لجداول البحث وخرائط الإعدادات ونتائج groupBy. وادمجه مع Partial وReadonly لمزيد من التحكم.

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

هل درس «‏Record: ربط المفاتيح بأنواع القيم» مجاني؟

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

ماذا ستتعلم في «‏Record: ربط المفاتيح بأنواع القيم»؟

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

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

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

كم من الوقت يستغرق درس «‏Record: ربط المفاتيح بأنواع القيم»؟

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

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

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

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

  1. ‏Partial وRequired: تبديل الاختيارية
  2. ‏Pick وOmit: اختيار الخصائص
  3. ‏Record: ربط المفاتيح بأنواع القيم
  4. ‏Readonly وExclude وExtract وNonNullable
← العودة إلى TypeScript Academy