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

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

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

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

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

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

تتيح واجهة برمجة التطبيقات 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. في صفحة العرض التجريبي، انقر على تحديد موعد إرسال الإشعار والسماح عندما يُطلب منك ذلك.

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

    سجلّ للأحداث في لوحة "الإشعارات"

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

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

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

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

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

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

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

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

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

    عناوين URL التي تم تحميلها بناءً على توقّع في هذه الصفحة، وحدث نجاحان وحالة تعذّر واحدة

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

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

    تم اختيار التخمين الذي تعذّر تنفيذه.

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

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

    قسم "القواعد" الذي يتضمّن رابطًا يؤدي إلى مجموعة القواعد

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

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

لعرض إشعار فوري للمستخدم، يجب أن يستخدم عامل الخدمة أولاً واجهة برمجة التطبيقات 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

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

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

حالة التقرير

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

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

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