شارك المقالة
شرح try وcatch في Dart وFlutter ومعالجة أخطاء Future

شرح try وcatch في Dart وFlutter ومعالجة أخطاء Future

شرح try وcatch في Dart لمعالجة أخطاء Future باستخدام await، والتمييز بين فشل متوقع وخطأ برمجي دون إخفاء سبب المشكلة.

شرح try وcatch في Dart لمعالجة أخطاء Future باستخدام await، والتمييز بين فشل متوقع وخطأ برمجي دون إخفاء سبب المشكلة.

الالتقاط لا يجعل العملية ناجحة

try يحدد منطقة قد ترمي استثناء، وcatch يستقبل الاستثناء إذا وصل إليه. لا تعني try تنفيذ المهام عشوائيًا أو تغيير ترتيبها، ولا تمثل بديلًا عن await. عند فشل قراءة ملف أو تحويل نص يجب أن يقرر التطبيق ماذا يعرض أو يعيد، بدل تحويل الفشل إلى قيمة صحيحة زائفة مثل صفر أو قائمة فارغة في كل الحالات. الدالة التي تخفي كل استثناء تمنع المستهلك من التمييز بين عدم وجود بيانات وتعذر تحميلها.

الأخطاء غير المتزامنة تحتاج انتظارًا

إذا استدعيت دالة تعيد Future داخل try ثم خرجت دون await، فقد يحدث الخطأ بعد انتهاء النطاق الذي توقعت التقاطه. انتظر Future داخل try، أو أعد سلسلة Future مع معالجة موثقة لأنواع القيم. then وcatchError لهما قواعد أنواع؛ إعادة قيمة مختلفة عن النوع المتوقع قد تسبب خطأ جديدًا أثناء معالجة الخطأ الأصلي. اختيار async/await غالبًا يجعل مسار النجاح والفشل أوضح، لكنه لا يلغي الحاجة إلى فهم ما تنتظره.

اختر المعالجة حسب السبب

يمكن استخدام on FormatException لمدخل لا يقبل التحويل، ثم معالجة أخرى عند حدود التطبيق لما لا تتوقعه. احتفظ بـ stack trace عند التسجيل الآمن كي يستطيع المطور تشخيص موضع الفشل، ولا تعرض تفاصيله الخام للمستخدم. لا تسجل كلمة مرور أو token أو استجابة حساسة كاملة. أخطاء البرمجة مثل الوصول إلى فهرس غير صالح تحتاج إصلاح المنطق؛ إخفاؤها بزر إعادة المحاولة ليس علاجًا دائمًا.

finally وإعادة الرمي

finally ينفذ التنظيف عندما يغادر المسار النطاق سواء نجح أو فشل، مثل إعادة حالة التحميل في مثال واجهة مناسب. لا تضع فيه عملية تدميرية لمجرد أنها ستنفذ دائمًا، وانتبه إلى أن رمي خطأ جديد أثناء التنظيف قد يغطي السبب الأصلي. عندما لا تملك قرار التعافي ويمكنك إضافة سياق آمن، استخدم rethrow من داخل catch للاحتفاظ بمسار الاستثناء. لا تستخدم throw error بدلًا منه تلقائيًا إذا أردت الحفاظ على أثر الرمي الأصلي.

اختبار الخطأ جزء من عقد الدالة

المثال يقرأ نصًا ويمرره إلى int.parse؛ الإدخال غير الرقمي ينتج رسالة مفهومة. جرّب عددًا صحيحًا ومسافة وسلسلة فارغة وقيمة غير رقمية، وحدد مسبقًا هل تسمح بالإشارة السالبة. إذا كان الغياب متوقعًا دون حاجة لاستثناء، فقد يكون int.tryParse مناسبًا. في Flutter اختبر أن رسالة الخطأ تظهر وأن زر المحاولة يعود للعمل، وألا تستعمل context بعد مغادرة الصفحة. نجاح مسار واحد لا يثبت معالجة بقية الحالات.

رسالة المستخدم تختلف عن سجل المطور

احتفظ بخريطة للأخطاء القابلة للتعافي: بيانات إدخال غير صالحة، مهلة انتظار، جلسة منتهية، ورفض صلاحية. لكل حالة نص وإجراء مناسب، فلا تعِد محاولة تسجيل دخول فاشل إلى الأبد، ولا تعرض خطأ صلاحية باعتباره اتصالًا ضعيفًا. استخدم معرّف طلب غير حساس لربط بلاغ المستخدم بسجل الخادم عندما يدعم نظامك ذلك. لا تضع كامل جسم الطلب في رسالة الخطأ، ولا تجعل catch العام يصنع نجاحًا شكليًا مثل إغلاق Dialog وإظهار تم الحفظ بينما فشلت الكتابة. جرّب الفشل بعد بدء التحميل وقبل اكتماله، وتأكد أن حالة الزر عادت وأن البيانات السابقة بقيت مفهومة. إذا نفذ الخادم عملية ثم انقطع الرد، تعامل مع النتيجة غير المؤكدة وفق آلية استعلام أو منع تكرار مناسبة بدل إعادة العملية الحساسة مباشرة.

مثال كامل للتجربة

ضع المثال في ملف مستقل داخل مشروع تجريبي. في أمثلة Flutter شغّل DemoPage داخل MaterialApp، ولا تدمج أكثر من main في الملف نفسه. البيانات محلية للتعلم ويمكن استبدالها بمصدر بيانات بعد فهم حالات النجاح والخطأ.

Future<int> readCount(String value) async => int.parse(value);
Future<void> main() async {
  for (final input in ['12', 'invalid']) {
    try {
      final count = await readCount(input);
      print('Count: $count');
    } on FormatException {
      print('Please enter a whole number');
    } finally {
      print('Attempt finished');
    }
  }
}

مرجع التفاصيل والتوافق

راجع التوثيق الرسمي عند نقل المثال إلى إصدار مختلف، ثم جرّب الحالة الطبيعية والفشل ومغادرة الصفحة أثناء الانتظار. دوّن السلوك المتوقع قبل تعديل منطق مشروعك.

الصور والفيديو من الشرح السابق

الكود النصي أعلاه هو النسخة المصححة؛ قد تختلف المواد المرئية السابقة في أسماء المتغيرات أو طريقة التشغيل.

كيفية تحديد المشكلة في العملية باستخدام ( Try and dCatch ) و ( then )
شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع