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

يمكنك إرسال أحداث استثناء لقياس عدد الأعطال أو الأخطاء التي تحدث على صفحة الويب ونوعها. توضّح هذه الصفحة كيفية استخدام 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	boolean	لا	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
  });
}