يوضّح هذا الدليل كيفية إرسال الاستثناءات باستخدام analytics.js. يتيح لك تتبُّع الاستثناءات قياس عدد الأعطال أو الأخطاء التي تحدث على موقعك ونوعها.
التنفيذ
يمكن إرسال نتائج الاستثناء باستخدام الأمر send
وتحديد hitType لـ exception
. يتضمن الأمر send
التوقيع التالي لنوع نتيجة exception
:
ga('send', 'exception', [fieldsObject]);
حقول الاستثناء
يلخص الجدول التالي حقول الاستثناء:
اسم الحقل | نوع القيمة | مطلوبة | الوصف |
---|---|---|---|
exDescription |
text | لا | وصف للاستثناء. |
exFatal |
boolean |
لا | true إذا كان الاستثناء خطيرًا. |
مثال
يوضح الأمر التالي بعض العمليات المنطقية التي قد تفشل في كتلة try/catch
. إذا حدث خطأ ما، يتم إرسال نتيجة استثناء إلى "إحصاءات Google":
try {
// Runs code that may or may not work.
window.possiblyUndefinedFunction();
} catch(err) {
ga('send', 'exception', {
'exDescription': err.message,
'exFatal': false
});
}