تصحيح أخطاء الخدمات التي تعمل في الخلفية

Kayce Basques

Sofia Emelianova

قسم الخدمات التي تعمل في الخلفية في "أدوات مطوّري البرامج في Chrome" هو مجموعة من الأدوات لواجهات برمجة التطبيقات JavaScript التي تتيح لموقعك الإلكتروني إرسال آخر الأخبار واستلامها حتى إذا لم يكن المستخدم قد فتح موقعك الإلكتروني. تشبه الخدمة التي تعمل في الخلفية وظيفيًا العملية التي تعمل في الخلفية.

يتيح لك قسم الخدمات التي تعمل في الخلفية تصحيح أخطاء الخدمات التالية التي تعمل في الخلفية:

• الاسترجاع في الخلفية
• المزامنة في الخلفية
• الإشعارات
• عمليات التحميل المبني على توقّع
• الرسائل الفورية

يمكن أن تسجِّل "أدوات مطوّري البرامج في Chrome" أحداث الجلب والمزامنة والإشعارات لمدة ثلاثة أيام، حتى عندما تكون الأدوات غير مفتوحة. يمكن أن يساعدك ذلك في التأكّد من إرسال الأحداث واستلامها على النحو المتوقّع.

بالإضافة إلى أحداث الخدمات التي تعمل في الخلفية، يمكن لأداة DevTools إجراء ما يلي:

• عرض التقارير التي أرسلها Chrome أو على وشك إرسالها باستخدام Reporting API
• تتيح لك هذه الميزة تصحيح الأخطاء واختبار ميزة "التخزين المؤقت للصفحات" بنقرة واحدة.

استرجاع البيانات في الخلفية

تتيح واجهة برمجة التطبيقات Background Fetch API لـ عامل الخدمة تنزيل موارد كبيرة بشكل موثوق، مثل الأفلام أو ملفات البودكاست، كخدمة تعمل في الخلفية. لتسجيل أحداث الجلب في الخلفية لمدة ثلاثة أيام، حتى عندما تكون أدوات مطوّري البرامج غير مفتوحة:

1. افتح أدوات مطوّري البرامج، على سبيل المثال، في هذه الصفحة التجريبية.

2. انتقِل إلى التطبيق > الخدمات التي تعمل في الخلفية > الاسترداد في الخلفية، وانقر على تسجيل.

   

3. في صفحة العرض التجريبي، انقر على تخزين مواد العرض على الجهاز. يؤدي ذلك إلى بدء بعض الأنشطة في الخلفية. تسجِّل أدوات مطوّري البرامج الأحداث في الجدول.

   

4. انقر على حدث معيّن للاطّلاع على تفاصيله في المساحة أسفل الجدول.

5. يمكنك إغلاق أدوات مطوّري البرامج وترك التسجيل قيد التشغيل لمدة تصل إلى ثلاثة أيام. لإيقاف التسجيل، انقر على إيقاف.

مزامنة الخلفية

تتيح Background Sync API لـ عامل الخدمة بلا إنترنت إرسال البيانات إلى خادم بعد أن تتم إعادة ربطه بالإنترنت بشكل موثوق. لتسجّيل أحداث المزامنة في الخلفية لمدة ثلاثة أيام، حتى عندما تكون أدوات مطوّري البرامج غير مفتوحة:

1. افتح أدوات مطوّري البرامج، على سبيل المثال، في هذه الصفحة التجريبية.

2. انتقِل إلى التطبيق > الخدمات التي تعمل في الخلفية > المزامنة في الخلفية وانقر على تسجيل.

   

3. في صفحة العرض التجريبي، انقر على تسجيل المزامنة في الخلفية لتسجيل عامل الخدمة المعني، ثم انقر على السماح عندما يُطلب منك ذلك.

   ملاحظة: للتعرّف على كيفية تصحيح أخطاء مهام الخدمة في "أدوات مطوّري البرامج"، يُرجى الاطّلاع على مهام الخدمة.

   إنّ تسجيل مشغّل الخدمة هو نشاط مزامنة في الخلفية. تسجِّل أدوات مطوّري البرامج الأحداث في الجدول.

   

4. انقر على حدث معيّن للاطّلاع على تفاصيله في المساحة أسفل الجدول.

5. يمكنك إغلاق أدوات مطوّري البرامج وترك التسجيل قيد التشغيل لمدة تصل إلى ثلاثة أيام. لإيقاف التسجيل، انقر على إيقاف.

(ميزة تجريبية) إجراءات الحدّ من التتبّع الارتدادي

ملاحظة: هذه ميزة تجريبية متاحة من الإصدار 115 من Chrome.

تتيح لك تجربة إجراءات الحدّ من تتبُّع معدلات الارتداد في Chrome تحديد حالة المواقع الإلكترونية التي يبدو أنّها تُجري تتبُّعًا على مستوى مواقع إلكترونية متعددة باستخدام تقنية تتبُّع معدلات الارتداد وحذفها. يمكنك فرض إجراءات تخفيف التتبّع يدويًا والاطّلاع على قائمة بالمواقع الإلكترونية التي تم حذف حالاتها.

لفرض إجراءات الحدّ من التتبّع:

1. حظر ملفات تعريف الارتباط التابعة لجهات خارجية في Chrome انتقِل إلى > الإعدادات > الخصوصية والأمان > ملفات تعريف الارتباط وبيانات المواقع الإلكترونية الأخرى > حظر ملفات تعريف الارتباط التابعة لجهات خارجية.
2. في chrome://flags، اضبط تجربة إجراءات الحدّ من التتبّع الارتدادي على مفعّلة مع حذف.
3. افتح "أدوات المطوّر"، على سبيل المثال، في صفحة العرض، وانتقِل إلى التطبيق > الخدمات التي تعمل في الخلفية > إجراءات الحدّ من تتبُّع عمليات الارتداد.
4. في صفحة العرض التجريبي، انقر على رابط إعادة التوجيه وانتظر (10 ثوانٍ) حتى يسجّل Chrome عملية إعادة التوجيه. تحذّرك علامة التبويب المشاكل من حذف الحالة القادم.
5. انقر على فرض التشغيل لحذف الحالة على الفور.

الإشعارات

بعد أن يتلقّى عامل الخدمة رسالة إشعار فوري من خادم، يستخدم عامل الخدمة واجهة برمجة التطبيقات Notifications لعرض البيانات للمستخدم. لتسجيل الإشعارات لمدة ثلاثة أيام، حتى عندما تكون "أدوات مطوّري البرامج" غير مفتوحة:

1. افتح أدوات مطوّري البرامج، على سبيل المثال، في هذه الصفحة التجريبية.

2. انتقِل إلى التطبيق > الخدمات التي تعمل في الخلفية > الإشعارات وانقر على تسجيل.

   

3. في صفحة العرض التجريبي، انقر على تحديد موعد إرسال الإشعار والسماح عندما يُطلب منك ذلك.

4. انتظِر ظهور الإشعار. تسجِّل أدوات المطوّرين أحداث الإشعارات في الجدول.

   

5. انقر على حدث معيّن للاطّلاع على تفاصيله في المساحة أسفل الجدول.

6. يمكنك إغلاق أدوات مطوّري البرامج وترك التسجيل قيد التشغيل لمدة تصل إلى ثلاثة أيام. لإيقاف التسجيل، انقر على إيقاف.

عمليات التحميل المبني على توقّع

تسمح عمليات التحميل المبني على توقّع بتحميل الصفحة بشكل شبه فوري استنادًا إلى قواعد التوقّع التي تحدّدها. يتيح ذلك لموقعك الإلكتروني تحميل الصفحات الأكثر زيارة مسبقًا وعرضها مسبقًا.

تُستخدَم ميزة "التحميل المُسبَق" لجلب مورد مُسبَقًا، وتُستخدَم ميزة "العرض المُسبَق" لعرض الصفحة بأكملها في عملية عرض مخفية في الخلفية.

يمكنك تصحيح أخطاء عمليات التحميل المبني على توقّع في قسم التطبيق > الخدمات التي تعمل في الخلفية > عمليات التحميل المبني على توقّع. يحتوي القسم على ثلاث طرق عرض:

• عمليات التحميل المبني على توقّع: يحتوي على الحالة التوقّعية للصفحة الحالية وعنوان URL الحالي والصفحات التي تحاول الصفحة الحالية تحميلها بشكل توقّعي وحالاتها.
• القواعد: يحتوي على مجموعات القواعد في الصفحة الحالية في لوحة العناصر والحالة العامة للتكهّنات.
• التكهّنات: يحتوي على جدول يحتوي على معلومات عن محاولات التحميل التوقّعي وحالاتها. إذا تعذّرت إحدى المحاولات، يمكنك النقر عليها في الجدول للاطّلاع على معلومات تفصيلية وسبب تعذّرها.

جرِّب تصحيح أخطاء عمليات التحميل المبني على توقّع في هذه الصفحة التجريبية:

1. افتح "أدوات المطوّر" في الصفحة وانتقِل إلى التطبيق > الخدمات التي تعمل في الخلفية > عمليات التحميل التوقّعي. إذا لم تتمكّن من رؤية أي عمليات تحميل مستندة إلى توقّعات بدأتها الصفحة، أعِد تحميلها.

   

2. تعرض صفحة البدء في العرض التوضيحي صفحتَين مُسبَقًا وتعذّر عليها عرض صفحة واحدة مُسبَقًا. انقر على عرض كل التوقّعات.

3. في قسم التكهّنات، اختَر التكهّن الذي يحمل الحالة تعذّر للاطّلاع على قسم سبب التعذّر الذي يتضمّن معلومات مفصّلة في أسفل الصفحة.

   

   في هذه الحالة، تعذّر العرض المُسبَق بسبب عدم توفّر صفحة /next3.html على الموقع الإلكتروني.

4. افتح قسم القواعد وانقر على الحالة للاطّلاع على مجموعة القواعد في أسفل الصفحة. يؤدي النقر على رابط مجموعة القواعد إلى نقلك إلى لوحة العناصر ويعرض لك مكان تحديد قاعدة التكهّن.

   

   ملاحظة: لا يمكنك إصلاح القاعدة على هذه الشاشة أو في لوحة العناصر لأنّ "أدوات مطوّري البرامج في Chrome" لا تُبقي تغييرات DOM العشوائية محفوظة عند تحميل الصفحات. عليك إصلاح القاعدة من المصدر من خلال إعداد مساحة عمل أو محاكاة التغيير من خلال استبدال المحتوى.

للحصول على دليل تفصيلي أكثر، يُرجى الاطّلاع على تصحيح أخطاء قواعد التوقّعات.

إرسال رسائل من الخادم

لعرض إشعار فوري للمستخدم، يجب أن يستخدم عامل الخدمة أولاً واجهة برمجة التطبيقات Push Message لتلقّي البيانات من خادم. عندما يكون عامل الخدمة جاهزًا لعرض الإشعار، يستخدم واجهة برمجة التطبيقات Notifications. لتسجيل رسائل الإشعارات الفورية لمدة ثلاثة أيام، حتى عندما تكون أدوات مطوّري البرامج غير مفتوحة:

1. افتح أدوات مطوّري البرامج، على سبيل المثال، في هذه الصفحة التجريبية.

2. انتقِل إلى التطبيق > الخدمات التي تعمل في الخلفية > الرسائل الفورية وانقر على تسجيل.

   

3. في صفحة العرض التجريبي، فعِّل تفعيل الإشعارات الفورية، وانقر على السماح عندما يُطلب منك ذلك، واكتب رسالة وأرسِلها. تسجِّل أدوات المطوّرين أحداث الإشعارات الفورية في الجدول.

   

   ملاحظة: بالإضافة إلى ذلك، في التطبيق > عمال الخدمة، يمكنك النقر على الدفع لإرسال إشعارات اختبار من "أدوات المطوّر".

4. انقر على حدث معيّن للاطّلاع على تفاصيله في المساحة أسفل الجدول.

5. يمكنك إغلاق أدوات مطوّري البرامج وترك التسجيل قيد التشغيل لمدة تصل إلى ثلاثة أيام. لإيقاف التسجيل، انقر على إيقاف.

Reporting API

تحدث بعض الأخطاء في مرحلة الإنتاج فقط. ولا تظهر لك هذه الأخطاء مطلقًا على الجهاز أو أثناء التطوير لأنّ المستخدمين والشبكات والأجهزة الفعلية تغيّر قواعد اللعبة.

على سبيل المثال، لنفترض أنّ موقعك الإلكتروني الجديد يعتمد على برنامج تابع لجهة خارجية يستخدم document.write() لتحميل النصوص البرمجية المهمة. يفتح المستخدمون الجدد موقعك الإلكتروني في جميع أنحاء العالم، ولكن قد تكون اتصالاتهم أبطأ من تلك التي تم اختبارها. يبدأ موقعك الإلكتروني في تعطُّل على هؤلاء المستخدمين بدون علمك لأنّ Chrome يتدخل ضد document.write() على الشبكات البطيئة. بدلاً من ذلك، يمكنك مراقبة واجهات برمجة التطبيقات التي تم إيقافها نهائيًا أو التي سيتم إيقافها قريبًا والتي قد يستخدمها رمزك البرمجي.

تم تصميم Reporting API لمساعدتك في مراقبة طلبات البيانات من واجهة برمجة التطبيقات التي سيتم إيقافها نهائيًا وانتهاكات الأمان في صفحتك وغير ذلك. يمكنك إعداد التقارير على النحو الموضّح في مقالة مراقبة تطبيق الويب باستخدام Reporting API.

للاطّلاع على التقارير التي أنشأتها صفحة معيّنة:

1. انتقِل إلى chrome://flags/#enable-experimental-web-platform-features، واضبط ميزات منصة الويب التجريبية على مفعَّلة، ثم أعِد تشغيل Chrome.

2. افتح "أدوات مطوّري البرامج في Chrome" وانتقِل إلى التطبيق > الخدمات التي تعمل في الخلفية > Reporting API. على سبيل المثال، يمكنك الاطّلاع على التقارير في هذه الصفحة التجريبية.

   

تنقسم علامة التبويب Reporting API إلى ثلاثة أجزاء:

• جدول التقارير الذي يتضمّن المعلومات التالية عن كل تقرير:
  • عنوان URL الذي أدّى إلى إنشاء التقرير
  • نوع الانتهاك
  • حالة البلاغ
  • نقطة نهاية الوجهة
  • الطابع الزمني لوقت إنشاء التقرير
  • نص التقرير
• قسم معاينة نص التقرير لمعاينة نصّ تقرير، انقر على تقرير في جدول التقارير.
• قسم نقاط النهاية الذي يقدّم نظرة عامة على جميع نقاط النهاية التي تم ضبطها في عنوان Reporting-Endpoints

حالة التقرير

يُعلمك عمود الحالة بما إذا كان Chrome قد أرسل التقرير بنجاح أو كان على وشك إرساله أو تعذّر عليه إرساله.

الحالة	الوصف
Success	أرسل المتصفّح التقرير وردّت نقطة النهاية برمز نجاح (200 أو رمز استجابة نجاح آخر 2xx).
Pending	يحاول المتصفّح إرسال التقرير.
Queued	تمّ إنشاء التقرير ولا يحاول المتصفّح إرساله بعد. يظهر التقرير على شكل Queued في إحدى الحالتَين أدناه: التقرير جديد وينتظر المتصفّح لمعرفة ما إذا كان سيصل المزيد من التقارير قبل محاولة إرساله. التقرير ليس جديدًا، فقد حاول المتصفّح إرسال هذا التقرير وتعذّر عليه إكمال العملية، وهو في انتظار إعادة المحاولة.
MarkedForRemoval	بعد إعادة المحاولة لفترة (Queued)، توقّف المتصفّح عن محاولة إرسال التقرير وسيزيله قريبًا من قائمة التقارير المطلوب إرسالها.

تتم إزالة البلاغات بعد فترة، سواء تم إرسالها بنجاح أم لا.

ملاحظة مهمة: لا تكون الحالة Queued مفيدة دائمًا، لأنّها لا تشير بدقة إلى ما إذا كان الإرسال قد تعذّر أو لم تتم تجربته بعد. يساعد استخدام تأخيرات قصيرة في إعداد التقارير: إذا ظلّ التقرير Queued في هذه الحالة، يشير ذلك على الأرجح إلى تعذُّر الإرسال.