قياس الاستثناءات

يمكنك إرسال أحداث استثنائية لقياس عدد الأعطال ونوعها أو الأخطاء التي تحدث على صفحة الويب. توضّح هذه الصفحة كيفية استخدام gtag.js لإرسال باستثناء بيانات "إحصاءات Google"

التنفيذ

عند حدوث خطأ، أرسِل حدث استثناء إلى "إحصاءات Google":

gtag('event', 'exception', {<exception_parameters>});

حيث <exception_parameters> هو زوج واحد أو أكثر من أزواج المعامل والقيم. منفصل كل زوج بفاصلة. على سبيل المثال، يرسل هذا الأمر خطأً غير فادح .

gtag('event', 'exception', {
  'description': 'error_description',
  'fatal': false   // set to true if the error is fatal
});

مَعلمات الاستثناء

يسرد الجدول التالي مَعلمات الاستثناء:

اسم المعلَمة نوع البيانات مطلوب الوصف
description سلسلة لا وصف للخطأ.
fatal منطقي لا true إذا كان الخطأ فادحًا.

مثال

بالنظر إلى الدالة التالية:

function divide(x, y) {
  if (y === 0) {
    throw "Division by zero";
  }
  return x/y;
}

سيُرسِل الرمز التالي حدث استثناء إلى "إحصاءات Google" إذا القاسم ص تساوي صفر:

var x = document.getElementById('x').value;
var y = document.getElementById('y').value;

try {
  var r = divide(x, y);
} catch(err) {
  gtag('event', 'exception', {
    'description': err,
    'fatal': false
  });
}