تحذيرات المتصفح من زبائنك قبل أن يتعطل موقعك: ReportingObserver
باختصار: المتصفحات تتغير باستمرار، وبعض ما يستخدمه موقعك اليوم قد يتوقف عن العمل في إصدار قادم. المتصفح غالباً يعرف ذلك مسبقاً، ويكتب تحذيراً في وحدة تحكم المطور، لكن لا أحد في متجرك أو عيادتك يفتح وحدة التحكم على جوالات الزبائن. واجهة ReportingObserver تتيح لكود صفحتك أن يستقبل هذه التحذيرات نفسها من متصفحات الزوار: تقارير الميزات المهملة (deprecation)، وتقارير التدخل (intervention) حين يمنع المتصفح شيئاً يحاول كودك فعله. في هذا المقال نشرح ما الذي تلتقطه هذه الواجهة، وكيف تجمع التقارير بطريقة خفيفة، وكيف تقرأها لتعرف ماذا تصلح أولاً قبل أن يشتكي زبون من زر لا يعمل.
لماذا تحتاج تحذيرات من متصفحات الزبائن
موقع متجرك أو نظام حجز عيادتك قد يكون بُني قبل سنوات، وأضيفت إليه مكتبات وإضافات من جهات مختلفة. عندما يقرر متصفح ما إزالة ميزة قديمة، يحذّر عادة قبل فترة. المشكلة أن التحذير يظهر في وحدة تحكم المتصفح على جهاز الزبون، لا في بريدك. وعندما تتوقف الميزة فعلاً، يكون أول ما تعرفه رسالة زبون تقول: "ما عم يزبط الدفع" أو "الخريطة ما بتفتح".
ما تريده هو أن تصل هذه التحذيرات إليك أنت، مع اسم الصفحة والملف والسطر الذي سببها، كي تعطيها للمطور قبل أن تصبح عطلاً.
ما هي Reporting API وReportingObserver
تشرح MDN أن Reporting API توفر آلية عامة لتطبيقات الويب كي تتيح التقارير المبنية على ميزات المنصة المختلفة بطريقة متسقة، مثل مخالفات سياسة أمن المحتوى، ومخالفات Permissions-Policy، واستخدام الميزات المهملة، أي التي ستتوقف عن العمل قريباً في المتصفحات، وحالات تدخل المتصفح، أي حين يمنع شيئاً يحاول كودك فعله لأنه خطر أمني مثلاً أو مزعج ببساطة.
وتوضح MDN طريقتين للحصول على التقارير: إرسالها من المتصفح مباشرة إلى نقطة استقبال على خادمك عبر ترويسة Reporting-Endpoints، أو التقاطها داخل الصفحة بكائن ReportingObserver. وتذكر MDN أن الطريقة الثانية ليست بالموثوقية نفسها، لأن انهيار الصفحة قد يمنعك من استرجاع التقارير، لكنها أسهل إعداداً وأكثر مرونة.
وبحسب MDN، صارت ReportingObserver ضمن Baseline منذ مارس 2026، أي تعمل في أحدث الأجهزة والمتصفحات، مع تنبيه أنها قد لا تعمل في الأقدم.
أنواع التقارير التي تهمك
تعدد MDN أنواع التقارير، ولصاحب موقع أعمال يكفي غالباً نوعان للبداية:
- deprecation: ميزات مهملة يستخدمها موقعك.
- intervention: ميزات منعها المتصفح، مثل إعلانات تؤثر بشدة على أداء الصفحة بحسب مثال MDN.
وتنبه MDN إلى أن تقارير الانهيار crash لا يمكن رصدها بجافاسكربت، لأن الصفحة التي ترصدها تكون قد انهارت.
مثال توضيحي: التقاط التقارير وإرسالها
مثال توضيحي لمتجر إلكتروني في عمّان:
if ('ReportingObserver' in window) {
const observer = new ReportingObserver((reports) => {
const data = reports.map(r => ({
type: r.type,
page: location.pathname,
body: r.body
}));
fetch('/browser-reports', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(data),
keepalive: true
});
}, { types: ['deprecation', 'intervention'], buffered: true });
observer.observe();
}
الخيار buffered، بحسب صفحة المُنشئ في MDN، يحدد هل تُرصد التقارير التي نشأت قبل إنشاء الكائن. ولأن التحذيرات قد تظهر أثناء تحميل الصفحة قبل أن يعمل كودك، فتفعيله مفيد. وإذا حذفت خيار types، تقول MDN إن كل الأنواع المدعومة تُجمع.
وتذكر MDN أيضاً أن الكائن يملك الدوال observe لبدء الجمع، وtakeRecords لإرجاع التقارير الموجودة في الطابور وتفريغه، وdisconnect لإيقاف الجمع.
لاحظ أننا أرسلنا المسار location.pathname لا الرابط الكامل. الرابط الكامل قد يحمل في نهايته رقم طلب أو رقم هاتف زبون في بعض المواقع، ولا داعي لجمع ذلك.
كيف تقرأ تقرير الميزة المهملة
تشرح MDN في صفحة DeprecationReport أن جسم التقرير يحتوي حقولاً مفيدة:
- id: نص يحدد الميزة المهملة، ويمكن استخدامه لتجميع التقارير حسب الميزة.
- anticipatedRemoval: تاريخ يُتوقع فيه إزالة الميزة. وتقول MDN إنه إذا كانت قيمته null لأن التاريخ غير معروف، فالإهمال يُعتبر أولوية منخفضة.
- message: وصف مقروء للإهمال، يشمل غالباً الميزة الأحدث البديلة، ويطابق عادة الرسالة التي يعرضها المتصفح في وحدة التحكم.
- sourceFile وlineNumber: مسار الملف والسطر حيث استُخدمت الميزة، إن كانا معروفين.
هذه الحقول تحول التحذير من رسالة غامضة إلى مهمة واضحة: هذه الميزة، في هذا الملف، يُتوقع إزالتها في هذا التاريخ.
رتّب الأولويات
عندما تبدأ التقارير بالوصول، رتبها هكذا:
- اجمع التقارير حسب id ثم حسب الملف.
- ابدأ بما له تاريخ إزالة قريب، واترك ما قيمته null لاحقاً كما تنصح MDN.
- افصل ملفاتك عن ملفات الجهات الخارجية. إن كان التحذير من سكربت إضافة أو أداة خارجية، فالحل غالباً تحديثها أو التواصل مع مزودها، لا تعديل كودك.
- انتبه للصفحات الحساسة أولاً: الدفع، والحجز، ونموذج التواصل.
لا تُغرق خادمك
موقع بزيارات كثيرة قد يولد عدداً كبيراً من التقارير المتكررة. نصائح عملية:
- اجمع عينة من الزيارات فقط بدل كل زيارة.
- تجاهل التقرير المكرر في الجلسة نفسها.
- احذف التقارير القديمة بعد معالجتها.
- اجعل نقطة الاستقبال بسيطة، تستقبل وتخزن فقط، دون عمليات ثقيلة.
أين يفيد هذا في الأعمال الأردنية
- متجر إلكتروني بُني على قالب قديم وإضافات كثيرة لم تُراجع منذ سنوات.
- عيادة أو مختبر يعتمد على نظام حجز أو نتائج على الويب يستخدمه الناس من جوالات مختلفة.
- مطعم يضمّن خريطة أو أداة طلب من جهة خارجية في موقعه.
- شركة خدمات لديها بوابة للعملاء لتتبع الطلبات أو رفع المستندات.
في كل هذه الحالات، التحذير المبكر يعطيك وقتاً لتخطط للإصلاح بدل أن تصلح تحت ضغط شكاوى الزبائن.
ماذا تطلب من المطور
إن لم تكن أنت من يكتب الكود، فاطلب ثلاثة أشياء: إضافة الرصد على الصفحات المهمة مع إرسال المسار فقط، وتقريراً شهرياً قصيراً يجمع التحذيرات حسب الميزة والملف، وخطة إصلاح تبدأ بما له تاريخ إزالة.
ReportingObserver أم Reporting-Endpoints
ترويسة Reporting-Endpoints مناسبة إن كنت تتحكم بإعدادات الخادم وتريد تقارير لا تعتمد على كود الصفحة. أما ReportingObserver فمناسبة حين تريد إضافة سطر جافاسكربت دون تعديل الخادم، أو إرسال معلومات إضافية من الصفحة مع التقرير. ويمكن استخدام الطريقتين معاً.
أسئلة شائعة
هل تجمع ReportingObserver بيانات شخصية عن الزبائن؟
التقارير تتعلق بالكود والميزات لا بالزبون، لكنها تحمل رابط الصفحة. أرسل المسار فقط وتجنب جمع ما لا تحتاجه.
هل تلتقط انهيارات المتصفح؟
لا. بحسب MDN، تقارير الانهيار لا يمكن رصدها بجافاسكربت.
ماذا أفعل بتقرير من سكربت جهة خارجية؟
حدّث الإضافة أو الأداة إلى أحدث إصدار، وإن استمر التحذير فأبلغ مزودها مع نص الرسالة.
هل تعمل في كل المتصفحات؟
تذكر MDN أنها ضمن Baseline منذ مارس 2026، لكنها قد لا تعمل في الأجهزة والمتصفحات الأقدم، لذلك افحص وجودها قبل الاستخدام كما في المثال.
إذا أردت أن تعرف ما الذي سيتعطل في موقعك قبل أن يخبرك به الزبائن، تحدث معنا عن مراقبة موقعك.