0Pricing
TypeScript Academy · درس

معالجة الأخطاء في شيفرة TypeScript غير المتزامنة

أديروا الأخطاء غير المتزامنة باستخدام أغلفة وأدوات محددة الأنواع

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

مرحبًا

تضيف الدوال غير المتزامنة تعقيدًا إلى معالجة الأخطاء. ويضمن TypeScript التعامل مع حالات رفض Promise بطريقة صحيحة.

Try-Catch مع Async/Await

ضع استدعاءات await داخل try-catch لمعالجة حالات رفض Promise.
async function loadUser(id: number): Promise<User> {
  try {
    return await api.getUser(id);
  } catch (err: unknown) {
    if (err instanceof Error) throw new AppError(err.message);
    throw new AppError('Unknown error');
  }
}

أخطاء Promise.all

ترفض Promise.all عند أول رفض. ضعها داخل try-catch.
try {
  const [user, posts] = await Promise.all([getUser(id), getPosts(id)]);
} catch (err) { /* one or both failed */ }

Promise.allSettled

تعيد allSettled حالات النجاح والفشل معًا دون طرح استثناء.
const results = await Promise.allSettled([getUser(1), getPosts(1)]);
results.forEach(r => {
  if (r.status === 'fulfilled') console.log(r.value);
  else console.error(r.reason);
});

نتيجة غير متزامنة محددة النوع

اجمع بين العمليات غير المتزامنة ونمط Result لمعالجة الأخطاء بوضوح.
async function safeGet<T>(fn: () => Promise<T>): Promise<Result<T>> {
  try { return { ok: true, value: await fn() }; }
  catch (e) { return { ok: false, error: e as Error }; }
}

حالات الرفض غير المعالجة

استمع إلى حالات الرفض غير المعالجة في Node.js لمنع تعطل التطبيق.
process.on('unhandledRejection', (reason: unknown) => {
  console.error('Unhandled rejection:', reason);
  process.exit(1);
});

المهلة باستخدام Promise.race

طبّق نمط مهلة محدد النوع باستخدام Promise.race.
function withTimeout<T>(promise: Promise<T>, ms: number): Promise<T> {
  const timeout = new Promise<never>((_, reject) =>
    setTimeout(() => reject(new Error('Timeout')), ms));
  return Promise.race([promise, timeout]);
}

نمط إعادة المحاولة

طبّق إعادة محاولة غير متزامنة محددة النوع باستخدام أخطاء محددة النوع.
async function retry<T>(fn: () => Promise<T>, times: number): Promise<T> {
  for (let i = 0; i < times; i++) {
    try { return await fn(); } catch (e) { if (i === times - 1) throw e; }
  }
  throw new Error('Unreachable');
}

معالجة الأخطاء المتزامنة

تعامل مع الأخطاء عند تشغيل عمليات غير متزامنة بالتوازي.
const [userResult, postsResult] = await Promise.allSettled([
  getUser(id).then(u => ({ ok: true, value: u })).catch(e => ({ ok: false, error: e })),
  getPosts(id).then(p => ({ ok: true, value: p })).catch(e => ({ ok: false, error: e })),
]);

نشر الأخطاء في AsyncQueue

تنتقل الأخطاء في المكررات غير المتزامنة بشكل صحيح عند استخدام for-await.
async function* generate() {
  yield await fetchA();
  yield await fetchB(); // error here stops the loop
}
for await (const item of generate()) { process(item); }

الوسيط البرمجي للأخطاء محددة النوع في Next.js

استخدم حدود أخطاء محددة النوع في إجراءات الخادم.
'use server';
async function createUser(data: CreateUserDto): Promise<Result<User>> {
  return safeGet(() => db.user.create({ data }));
}

تحقق سريع

ماذا يحدث إذا لم تلتقط Promise مرفوضة داخل دالة async/await؟

مراجعة

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

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

هل درس «معالجة الأخطاء في شيفرة TypeScript غير المتزامنة» مجاني؟

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

ماذا ستتعلم في «معالجة الأخطاء في شيفرة TypeScript غير المتزامنة»؟

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

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

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

كم من الوقت يستغرق درس «معالجة الأخطاء في شيفرة TypeScript غير المتزامنة»؟

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

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

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

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

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