0Pricing
TypeScript Academy · درس

تضييق الأخطاء الملتقطة: ‏unknown أم Error

تعاملوا بأمان مع الأخطاء الملتقطة والمحددة بالنوع unknown

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

مرحبًا

منذ TypeScript 4.0، أصبحت الأخطاء الملتقطة من النوع unknown. وهذا يفرض تضييق النوع صراحةً قبل استخدام خصائص الخطأ.

تغيير TS 4.0

قدّم TypeScript 4.0 الخيار useUnknownInCatchVariables. وتصبح الأخطاء الملتقطة من النوع unknown في الوضع الصارم.
// err is now: unknown
try { doSomething(); }
catch (err) {
  // err.message; // Error — cannot access on unknown
}

تضييق النوع باستخدام instanceof

استخدم instanceof Error للوصول إلى خصائص الخطأ بأمان.
catch (err) {
  if (err instanceof Error) {
    console.error(err.message, err.stack);
  } else {
    console.error('Unknown error:', String(err));
  }
}

حارس النوع isError

أنشئ حارس نوع قابلًا لإعادة الاستخدام لتضييق نوع الخطأ.
function isError(e: unknown): e is Error {
  return e instanceof Error;
}
catch (e) {
  if (isError(e)) console.error(e.message);
}

تضييق أنواع الأخطاء المخصصة

ضيّق النوع إلى أنواع أخطاء مخصصة داخل كتل catch.
catch (err) {
  if (err instanceof NetworkError) { /* retry */ }
  else if (err instanceof AuthError) { /* redirect */ }
  else if (err instanceof Error) { /* generic */ }
  else throw err;
}

useUnknownInCatchVariables

يفرض هذا الخيار، وهو جزء من strict في TS 4.4 والإصدارات الأحدث، استخدام unknown للأخطاء الملتقطة.
{ "compilerOptions": { "useUnknownInCatchVariables": true } }

الأخطاء النصية

ترمي بعض الشيفرات سلاسل نصية بدلًا من كائنات Error. تعامل مع النوعين.
catch (err) {
  const message = err instanceof Error ? err.message : String(err);
  console.error(message);
}

دالة المساعدة Typed throw

أنشئ دالة مساعدة تطرح دائمًا خطأً من النوع Error.
function throwErr(msg: string, code = 500): never {
  const e: AppError = Object.assign(new Error(msg), { statusCode: code });
  throw e;
}

إعادة طرح الأخطاء غير المعروفة

أعد طرح الأخطاء التي لا تستطيع معالجتها.
catch (err) {
  if (err instanceof KnownError) handle(err);
  else throw err; // propagate unknowns
}

حدود الأخطاء في React

يجب أن تتعامل حدود الأخطاء في React مع الأخطاء غير المعروفة الصادرة من دوال دورة الحياة.
componentDidCatch(error: unknown, info: ErrorInfo) {
  if (error instanceof Error) logError(error.message);
}

اختبار الأخطاء الملتقطة

اختبر معالجة الأخطاء باستخدام تأكيدات محددة النوع.
test('catches errors', async () => {
  jest.spyOn(api, 'fetch').mockRejectedValue(new NetworkError());
  const result = await safeRun();
  expect(result.ok).toBe(false);
});

تحقق سريع

ما نوع الخطأ الملتقط `err` في الوضع الصارم في TypeScript 4.4 والإصدارات الأحدث؟

مراجعة

تضييق أنواع الأخطاء الملتقطة (unknown مقابل Error): تعلّمتم المفاهيم الأساسية لهذا الموضوع وكيفية تطبيقها في مشاريع TypeScript الحقيقية.

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

هل درس «تضييق الأخطاء الملتقطة: ‏unknown أم Error» مجاني؟

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

ماذا ستتعلم في «تضييق الأخطاء الملتقطة: ‏unknown أم Error»؟

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

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

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

كم من الوقت يستغرق درس «تضييق الأخطاء الملتقطة: ‏unknown أم Error»؟

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

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

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

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

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