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

Kayce Basques

Sofia Emelianova

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

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

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

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

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

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

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

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

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

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

   

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

   

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

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

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

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

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

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

   

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

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

   

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

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

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

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

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

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

الإشعارات

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

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

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

   

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

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

   

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

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

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

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

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

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

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

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

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

   

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

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

   

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

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

   

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

الإشعارات الفورية

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

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

2. انتقل إلى التطبيق > خدمات الخلفية > Push Messaging (المراسلة الفورية) وانقر على تسجيل.

   

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

   

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

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

Reporting API

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

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

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

لعرض التقارير التي تم إنشاؤها بواسطة إحدى الصفحات:

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

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

   

تنقسم علامة التبويب واجهة برمجة التطبيقات لإعداد التقارير إلى ثلاثة أجزاء:

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

حالة التقرير

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

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