error-handling
تنفيذ معالجة الأخطاء المنظمة
متاح أيضًا من: Doyajin174
بناء معالجة قوية للأخطاء يمثل تحدياً بدون أنماط متسقة. توفر هذه المهارة تسلسلات استثناءات جاهزة للاستخدام، وأنماط try-catch، ومعالجات أخطاء عامة، وأدوات تسجيل لتطبيقات FastAPI وReact.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "error-handling". أنشئ استثناء مخصص لحالة عدم العثور على مورد
النتيجة المتوقعة:
- class NotFoundError(AppException):
- """Resource not found (404)."""
- def __init__(self, resource: str, identifier: str):
- super().__init__(
- status_code=404,
- detail=f"{resource} with id '{identifier}' not found",
- user_message=f"{resource} not found. Please check and try again.",
- )
استخدام "error-handling". كيف يجب أن أنسق استجابات أخطاء API؟
النتيجة المتوقعة:
{
"error": {
"code": "STUDENT_NOT_FOUND",
"message": "Student not found. Please check and try again.",
"internal": "Student with id '12345' not found"
}
}
استخدام "error-handling". تعامل مع خطأ fetch في React واعرض إشعار toast
النتيجة المتوقعة:
try {
const response = await fetch(url);
if (!response.ok) {
throw new ApiResponseError(
{ code: "FETCH_ERROR", message: "Failed to fetch data" },
response.status
);
}
return response.json();
} catch (error) {
if (error instanceof ApiResponseError) {
toast.error(error.userMessage);
} else {
toast.error("An unexpected error occurred.");
}
}
التدقيق الأمني
آمنThis skill provides legitimate error handling patterns for FastAPI backends and React frontends. Static findings are false positives triggered by regex flags misidentified as cryptographic algorithms, backticks for markdown code formatting, and error code naming conventions. No malicious patterns confirmed.
عوامل الخطر
⚡ يحتوي على سكربتات (1)
⚙️ الأوامر الخارجية (2)
درجة الجودة
ماذا يمكنك بناءه
بناء استجابات أخطاء API متسقة
إنشاء تنسيق موحد لاستجابة الأخطاء عبر جميع نقاط نهاية API مع فئات استثناءات مخصصة، ورسائل موجهة للمستخدم، وتسجيل منظم لتسهيل تصحيح الأخطاء.
التعامل مع أخطاء API في الواجهة الأمامية بشكل أنيق
تنفيذ معالجة الأخطاء في تطبيقات React التي تعرض رسائل سهلة الاستخدام، وتتعامل مع فشل الشبكة، وتتكامل مع إشعارات toast.
تصحيح مشاكل الإنتاج باستخدام معرفات الارتباط
إعداد تسجيل منظم يتتبع الطلبات عبر الخدمات باستخدام معرفات الارتباط، مما يسهل تتبع الأخطاء في الأنظمة الموزعة.
جرّب هذه الموجهات
أنشئ فئة استثناء مخصصة تسمى {ExceptionName} تمتد من AppException لواجهة خلفية FastAPI. يجب أن تقبل {parameters} وتُرجع رمز حالة {status_code} مع رسالة سهلة الاستخدام.أضف معالج أخطاء عام إلى تطبيق FastAPI الخاص بي يلتقط AppException ويُرجع استجابة JSON متسقة مع رمز الخطأ ورسالة المستخدم والتفاصيل الداخلية في وضع التصحيح.
أنشئ دالة محول أخطاء في TypeScript تترجم استجابات أخطاء API إلى رسائل سهلة الاستخدام. يجب أن تتعامل مع رموز الحالة 401 و403 و404 و409 و422 و429 و500.
أنشئ مُسجل منظم في Python يُخرج سجلات JSON مع الطابع الزمني والمستوى ومعرف الارتباط ونوع الخطأ والرسالة وتتبع المكدس. استخدم contextvars لتتبع معرف الارتباط.
أفضل الممارسات
- فصل تفاصيل الأخطاء الداخلية عن الرسائل الموجهة للمستخدم لتجنب تسريب معلومات حساسة
- استخدام أنواع استثناءات محددة بدلاً من اللجوء إلى Exception العامة لتمكين معالجة أخطاء مستهدفة
- تسجيل الاستثناءات دائماً مع معرفات الارتباط لتتبع الأخطاء عبر الخدمات الموزعة
تجنب
- التقاط Exception أو عبارات except المجردة التي تبتلع جميع الأخطاء دون معالجة صحيحة
- كشف تتبع المكدس أو تفاصيل الأخطاء الداخلية مباشرة للمستخدمين في الإنتاج
- إرجاع تنسيقات استجابة أخطاء مختلفة عبر نقاط النهاية، مما يجعل معالجة أخطاء العميل غير متسقة