تقارير الأعطال والتعافي من الأخطاء: الموافقة المسبقة وشاشة الاحتياط

ما الذي يفعله

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

والثانية هي مُبلِّغ الأعطال. فحين يلتقط الحاجز خطأ رسم، أو حين يرى معالج عام رفضَ وعد غير معالَج أو خطأ غير ملتقَط خارج React، يُجمَّع تقرير ويُرسل، لكن فقط إن كنت قد وافقت. ويُخزَّن الإعداد محليًا تحت مفتاح واحد؛ وغيابه يعني لا موافقة. والإرسال من نوع «أطلق وانسَ»: فشاشة الخطأ لا يؤخرها الطلب أبدًا، والإرسال الفاشل يفشل بلا أي نافذة منبثقة.

الإعدادات

ماذا يحتوي التقرير

للحمولة ستة حقول: النوع (panic في جانب Rust، وrender لخطأ رسم في React، وunhandled لوعد مرفوض أو خطأ غير ملتقَط)، والرسالة، وأثر المكدس، وإصدار التطبيق، والمنصّة، والطابع الزمني. وتُقصّ الرسالة عند 1000 حرف وأثر المكدس عند 4000، مع الإبقاء على الإطارات العليا التي تحمل المعلومة.

وقبل وضعها في الحمولة، تمرّ الرسالة وأثر المكدس عبر منقٍّ يحجب مفاتيح واجهات الذكاء الاصطناعي، ورموز Bearer وBasic، ومسارات مستخدمي Windows وUnix (محدودةً عند فاصل المسار حتى لا يُسرّب اسمُ حساب Windows المكوَّن من كلمتين شطرَه الثاني)، وعناوين البريد، وأزواج المفتاح/القيمة الحساسة مثل password وtoken وapi_key وuser_id وunique_user_id وlogin وaccount. ويثبّت اختبارٌ هذه الأنماط بالصيغ الحقيقية التي تتخذها في رسائل أخطاء التطبيق. ولا تكون بيانات اعتماد الوسيط، ولا اسم الحساب، ولا المراكز، ولا الأرباح والخسائر، ولا الرموز المتداولة، ولا مفتاح الذكاء الاصطناعي جزءًا من التقرير أبدًا.

ويُبقي مخفِّضٌ تقريرًا واحدًا لكل بصمة مميزة (النوع مع أول 200 حرف من الرسالة المنقّاة)، وخمس بصمات مميزة على الأكثر في الجلسة، حتى لا تنتج حلقةُ رسم تُخفق كل إطار مئاتِ الطلبات.

كيف تستعمله

• إذا عرضت شاشة «توقفت هذه الشاشة»، فاضغط «أعد التحميل» أولًا. وإن تكرر الأمر، فاضغط «انسخ التفاصيل» والصق النص في تقرير من شاشة الإبلاغ عن مشكلة، فهي ترفق آخر أسطر الأخطاء تلقائيًا كذلك.
• فعّل تقارير الأعطال في صفحة الحساب إن أردت أن تصل أخطاء الرسم والأخطاء غير المعالَجة إلى المطورين بلا أي إجراء منك. والتسمية بجوار مربع الاختيار تذكر بدقة ما يُرسل وما لا يُرسل.
• شاشة الإبلاغ عن مشكلة قناة منفصلة وطوعية برسائل فشل ظاهرة خاصة بها؛ أما مُبلِّغ الأعطال فتلقائي وصامت بحكم التصميم.

الحدود والمزالق

• يغطي الحاجز أخطاء الرسم في منطقته. أما أخطاء ردود النداء والمؤقتات والاستيرادات الديناميكية فتلتقطها المعالجات العامة، وهي تبلّغ ولا تعرض البطاقة.
• الموافقة مفتاح واحد في التخزين المحلي على هذا الجهاز؛ وملفٌّ جديد، أو تخزين مُفرَّغ، أو تخزين لا يستطيع التطبيق قراءته، كلها تعني لا موافقة، فلا يُرسل شيء.
• يُرسل التقرير إلى النطاق الرسمي بمهلة خمس ثوانٍ؛ وإن كان الجهاز خارج الشبكة أُسقط التقرير ولم يُصطَف في طابور.