الانتقال إلى المحتوى الرئيسي

مقدمة

يلتقط Lerix الأخطاء من تطبيق Angular الخاص بك لتتمكّن من تصحيح المشاكل بشكل أسرع. بعد إتمام تثبيت Angular، استخدم LerixService.throwError() لإرسال أخطاء مخصّصة إلى لوحة التحكم — أما الأخطاء غير الملتقطة فتُلتقط تلقائياً، دون الحاجة لأي كود إضافي.
تأكّد من تسجيل الـ SDK عبر provideLerix() قبل الإبلاغ عن الأخطاء.

الإبلاغ عن خطأ

المعاملات (Parameters)

قيم BugType

قيم BugSeverity

الالتقاط التلقائي للأخطاء

يُثبّت provideLerix() التقاط الأخطاء بطريقتين، بحيث لا حاجة لتغليف أي شيء في try/catch للحصول على تغطية أساسية:
  • معالج ErrorHandler مخصّص خاص بـ Angular يلتقط أي شيء يُرمى داخل منطقة (zone) Angular — ربط القوالب (template bindings)، دوال دورة حياة المكوّنات، اشتراكات RxJS.
  • مستمعا window.onerror وَ unhandledrejection العامّان يلتقطان كل شيء آخر.
خلافاً لمعالج الأعطال في تطبيق أصلي (native)، لا يكون تبويب المتصفح على وشك الإنهاء عند حدوث أحد هذين — لذا يُرسَل التقرير فوراً بدلاً من حفظه لتشغيل لاحق. لتعطيل كليهما (مثلاً إذا كان تطبيقك يملك بالفعل نظام إبلاغ عن الأخطاء خاصاً به وتريد فقط استدعاءات throwError اليدوية):

الالتقاط التلقائي لتتبّع المكدس

عند استدعاء throwError() دون تمرير معامل stack، يُلتقط تتبّع مكدس تلقائياً من موضع الاستدعاء — لا تحتاج لتمريره صراحةً إلا عند الإبلاغ عن تتبّع مكدس خطأ (Error) ملتقَط بنفسك بدلاً من موضع استدعاء throwError (مثل error.stack?.split('\n')). في الحالتين، يُحلَّل كل إطار من إطارات المكدس من موضعه المُجمَّع (compiled/bundled) (مثل main.js:577:15) إلى ملف المصدر الأصلي وسطره، باستخدام خريطة المصدر (source map) الخاصة بالبناء نفسه — نفس الآلية التي تستخدمها أدوات المطوّرين (DevTools) في المتصفح لعرض تتبّعات مكدس مقروءة بدلاً من مواضع الحزمة (bundle) المُصغَّرة. يحدث هذا تلقائياً؛ لا حاجة لأي إعداد.
يتطلّب التحليل أن تكون خريطة المصدر متاحة على رابط الإطار — وهذا صحيح دائماً في بيئة التطوير، وصحيح في الإنتاج فقط إذا كان بناؤك يقدّم ملفات .map علناً. إذا أبقى بناء الإنتاج خرائط المصدر خاصة (خيار شائع)، ترجع الإطارات إلى موضعها المُجمَّع بدلاً من فشل الإبلاغ — التحليل هو أفضل محاولة (best-effort) ولا يعطّل أو يؤخّر التقرير نفسه أبداً.
لتحصل على تتبّعات مكدس مقروءة في الإنتاج مع إبقاء خرائط المصدر خاصة، ارفعها إلى Lerix بعد كل بناء. راجع خرائط المصدر لـ Angular.

تحقّق من التكامل

ثم افتح لوحة التحكم — يجب أن يظهر الخطأ خلال ثوانٍ، مع تتبّع مكدس محلَّل يشير إلى هذا السطر بالتحديد.

ترشيح الأخطاء

يتطلّب @lerix-dev/lerix-angular بالإصدار 1.2.0 أو أحدث. يحدّد خياران اختياريان في provideLerix() الأخطاء التي تُرسَل. ينطبقان على كل تقرير: ErrorHandler الخاص بـ Angular، والمعالجات العامة، وLerixService.throwError.
app.config.ts
  • تعمل ignoreErrors أولاً. النص (string) يحذف أي خطأ تحتوي رسالته عليه، دون تمييز حالة الأحرف. والتعبير RegExp يحذف أي خطأ تطابقه رسالته. تُتجاوَز النصوص الفارغة.
  • ثم لا ترى beforeSend إلا ما تبقّى. أعِد الحدث (معدّلاً أو كما هو) لإرساله، أو أعِد null لحذفه. إذا رمت استثناءً، يُرسَل الحدث الأصلي ولا يصل الاستثناء إلى تطبيقك.
  • الرسالة التي تطابقها هي عنوان المشكلة، وتتضمّن صنف الخطأ، مثل TypeError: boom.
تستقبل beforeSend كائن LerixErrorEvent: { message, stack, type, severity, metadata? }. والحقل stack مصفوفة من الإطارات، محلَّلة مسبقاً عبر خرائط المصدر. كما يجمّع Lerix الأخطاء المتكرّرة في مشكلة واحدة ويرشّح الضوضاء الشائعة على الخادم، لكل إصدارات الـ SDK. راجع كيف تُجمَّع الأخطاء في مشكلات.