بناء تطبيقات أكثر مرونة من خلال إتقان أنماط معالجة الأخطاء بما في ذلك الاستثناءات، وأنواع Result، ومنطق إعادة المحاولة، وقواطع الدائرة عبر Python وTypeScript وRust وGo.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "error-handling-patterns". كيف أتعامل مع الأخطاء عند استدعاء API خارجي؟
النتيجة المتوقعة:
لاستدعاءات API الخارجية، نفّذ طبقات متعددة من معالجة الأخطاء: (1) تسلسل هرمي مخصص للاستثناءات لأنواع الأعطال المختلفة، (2) إعادة المحاولة مع backoff أسي للأخطاء العابرة، (3) قاطع الدائرة لمنع الأعطال المتتالية، (4) التدهور التدريجي مع بيانات احتياطية. نهج مثال: أنشئ استثناءات مخصصة (NetworkError، TimeoutError، RateLimitError)، غلّف استدعاءات API في decorator إعادة محاولة مع 3 محاولات وbackoff أسي، استخدم قاطع الدائرة لتتبع معدلات الفشل، وفّر احتياطاً مخبّأً عندما يكون API غير متاح.
استخدام "error-handling-patterns". متى يجب استخدام أنواع Result بدلاً من الاستثناءات؟
النتيجة المتوقعة:
استخدم أنواع Result للإخفاقات المتوقعة (أخطاء التحقق من الصحة، أخطاء عدم العثور، أخطاء منطق العمل) حيث يجب على المستدعي التعامل صراحةً مع حالتي النجاح والفشل. استخدم الاستثناءات للحالات الاستثنائية حقاً (مؤشرات null، نفاد الذاكرة، أخطاء وقت التشغيل غير المتوقعة). تجعل أنواع Result معالجة الأخطاء صريحة في نظام النوع، مما يجبر المستدعين على النظر في حالات الفشل. في TypeScript، Result<T, E> = { ok: true, value: T } | { ok: false, error: E }. في Rust، المشغل ؟ ونوع Result<T, E> يوفران دعماً مدمجاً. هذا النهج يحسّن قابلية قراءة الكود ويقلل أخطاء وقت التشغيل غير المتوقعة.
التدقيق الأمني
آمنThis skill is a documentation and educational resource about error handling patterns. The static scanner flagged 49 potential issues, but after evaluation all findings are FALSE POSITIVES. The detected patterns (backtick syntax examples, HTTP library examples, error categories) are educational code snippets in markdown documentation, not executable malicious code. No security concerns identified.
درجة الجودة
ماذا يمكنك بناءه
تحسين موثوقية التطبيق
إضافة معالجة قوية للأخطاء للميزات الجديدة أو الموجودة مع تسلسلات هرمية مناسبة للاستثناءات ورسائل أخطاء ذات مغزى.
بناء أنظمة متسامحة مع الأعطال
تنفيذ منطق إعادة المحاولة، وقواطع الدائرة، والتدهور التدريجي للأنظمة الموزعة والخدمات المصغرة.
تعلم الأنماط عبر اللغات
فهم أساليب معالجة الأخطاء عبر Python وTypeScript وRust وGo لاختيار أفضل نهج لكل حالة.
جرّب هذه الموجهات
ساعدني في تنفيذ معالجة مناسبة للأخطاء لدالة تجلب بيانات المستخدم من قاعدة البيانات. أريد إنشاء فئات استثناءات مخصصة والتعامل مع سيناريوهات أخطاء مختلفة بشكل مناسب.
أظهر لي كيفية تنفيذ نمط نوع Result في TypeScript لتحليل بيانات JSON. ضمّن أنواع أخطاء مناسبة ومعالجة متسلسلة للأخطاء.
أنشئ decorator في Python ينفذ منطق إعادة المحاولة مع backoff أسي لاستدعاءات الشبكة. تعامل مع أنواع استثناءات مختلفة وضمّن محاولات قابلة للتكوين.
نفذ نمط قاطع الدائرة في Python لمنع الأعطال المتتالية عند استدعاء API خارجي. ضمّن الحالات المغلقة والمفتوحة ونصف المفتوحة.
أفضل الممارسات
- افشل بسرعة من خلال التحقق من المدخلات مبكراً وتوفير رسائل أخطاء ذات مغزى مع السياق
- احفظ سياق الخطأ بما في ذلك آثار المكدس، والطوابع الزمنية، والبيانات الوصفية ذات الصلة
- تعامل مع الأخطاء على المستوى المناسب حيث يمكنك الاستجابة لها بشكل ذي مغزى
- سجّل الأخطاء بشكل مناسب - سجّل الأخطاء غير المتوقعة، وليس إخفاقات التحقق من الصحة المتوقعة
تجنب
- الالتقاط بشكل واسع جداً باستخدام معالجات Exception عامة تخفي الأخطاء
- كتل catch فارغة تبتلع الأخطاء بصمت دون تسجيل أو معالجة
- إرجاع رموز أخطاء بدلاً من استخدام استثناءات مناسبة أو أنواع Result
- تجاهل أخطاء async من خلال عدم معالجة promise rejections بشكل صحيح
الأسئلة المتكررة
ما الفرق بين الاستثناءات وأنواع Result؟
متى يجب استخدام قاطع الدائرة؟
كيف يعمل الـ backoff الأسي لإعادة المحاولة؟
ما هو التدهور التدريجي؟
هل يجب التقاط الاستثناءات أم السماح لها بالانتشار؟
كيف أنشئ رسائل أخطاء ذات مغزى؟
تفاصيل المطور
المؤلف
sickn33الترخيص
MIT
المستودع
https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/error-handling-patternsمرجع
main
بنية الملفات