TypeScript Academy · درس

فئات الأخطاء وتسلسلاتها محددة الأنواع

أنشئوا فئات أخطاء مخصّصة باستخدام أنواع مميّزة

الدرس 1 من 413 خطوة

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

ترحيب

تمنح أصناف الأخطاء المخصّصة في TypeScript الأخطاءَ تسلسلًا هرميًا للأنواع، مما يتيح معالجتها بأمان وبنية واضحة.

توسيع Error

أنشئ صنف AppError أساسيًا مع statusCode.
class AppError extends Error {
  constructor(public message: string, public statusCode = 500) {
    super(message);
    this.name = 'AppError';
  }
}

التسلسل الهرمي للأخطاء

أنشئ أصنافًا فرعية محدّدة النوع لأنواع الأخطاء المختلفة.
class NotFoundError extends AppError {
  constructor(resource: string) { super(`${resource} not found`, 404); }
}
class ValidationError extends AppError {
  constructor(public fields: string[]) { super('Validation failed', 400); }
}

استخدام instanceof

استخدم instanceof لتضييق أنواع الأخطاء داخل كتل catch.
try { doSomething(); }
catch (err) {
  if (err instanceof NotFoundError) res.status(404).json({ error: err.message });
  else if (err instanceof ValidationError) res.status(400).json({ fields: err.fields });
}

اتحاد الأخطاء المميّز

استخدم اتحادًا مميّزًا لمعالجة الأخطاء مع تحديد أنواعها.
type AppError =
  | { kind: 'not_found'; resource: string }
  | { kind: 'unauthorized' }
  | { kind: 'validation'; fields: string[] };

دوال إنشاء الأخطاء

أنشئ دوال إنشاء لكل نوع من أنواع الأخطاء.
const errors = {
  notFound: (r: string) => new NotFoundError(r),
  unauthorized: () => new AppError('Unauthorized', 401),
};

تسلسل الأخطاء

حوّل الأخطاء إلى صيغة متسلسلة لاستخدامها في استجابات API.
function serializeError(err: AppError): Record<string, unknown> {
  return { error: err.message, code: err.statusCode, name: err.name };
}

تعيين this.name

عيّن this.name دائمًا إلى اسم صنف الخطأ لضمان تحديد الخطأ بشكل صحيح في السجلات.
class MyError extends Error {
  readonly name = 'MyError' as const;
  constructor(msg: string) { super(msg); }
}

الأخطاء في Express

استخدم أخطاء مخصّصة محدّدة النوع في معالجات أخطاء Express.
app.use((err: unknown, req: Request, res: Response, next: NextFunction) => {
  if (err instanceof AppError) {
    res.status(err.statusCode).json({ error: err.message });
  } else {
    res.status(500).json({ error: 'Internal error' });
  }
});

نمط تسجيل الأخطاء

سجّل الأخطاء مع نوعها ورسالتها لضمان إمكانية مراقبتها.
function logError(err: unknown): void {
  if (err instanceof Error) console.error(`[${err.name}] ${err.message}`);
  else console.error('Unknown error:', err);
}

اختبار أنواع الأخطاء

اختبر أن الدوال تطرح أنواع الأخطاء الصحيحة.
test('throws NotFoundError for missing user', async () => {
  await expect(getUser(999)).rejects.toThrow(NotFoundError);
});

تحقق سريع

ما الكلمة المفتاحية في TypeScript التي تتحقق وقت التشغيل مما إذا كان الكائن نسخة من صنف؟

مراجعة

أصناف الأخطاء وتسلسلاتها الهرمية المحدّدة النوع: تعلّمت المفاهيم الأساسية لهذا الموضوع وكيفية تطبيقها في مشاريع TypeScript الحقيقية.
البدء مجانًا

تعلم TypeScript مع معلم ذكاء اصطناعي — مجانًا

اكتب وقم بتشغيل أكوادك الفعلية في المتصفح، واحصل على مساعدة فورية من معلم ذكاء اصطناعي متاح 24/7، واستمر من حيث توقفت على الويب أو في التطبيق.

الدورات
101
الدروس
352

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

هل درس «فئات الأخطاء وتسلسلاتها محددة الأنواع» مجاني؟

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

ماذا ستتعلم في «فئات الأخطاء وتسلسلاتها محددة الأنواع»؟

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

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

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

كم من الوقت يستغرق درس «فئات الأخطاء وتسلسلاتها محددة الأنواع»؟

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

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

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

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

  1. فئات الأخطاء وتسلسلاتها محددة الأنواع
  2. نمط Result: ‏Ok وErr
  3. تضييق الأخطاء الملتقطة: ‏unknown أم Error
  4. معالجة الأخطاء في شيفرة TypeScript غير المتزامنة
← العودة إلى TypeScript Academy