دورة حياة عامل الخدمات

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

هذه نظرة متعمّقة، ولكن النقاط في بداية كل قسم تغطي معظم ما تحتاج إلى معرفته.

النية

الهدف من دورة الحياة هو:

  • إتاحة إمكانية العمل بلا إنترنت أولاً
  • السماح لمشغّل خدمات جديد بالاستعداد بدون تعطيل المشغّل الحالي
  • تأكَّد من أنّ الصفحة المشمولة في النطاق يتحكّم فيها مشغّل الخدمات نفسه (أو لا يتحكّم فيها أي مشغّل خدمات) طوال الوقت.
  • تأكَّد من تشغيل نسخة واحدة فقط من موقعك الإلكتروني في كل مرة.

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

أول عامل خدمة

وباختصار:

  • الحدث install هو أول حدث يتلقّاه مشغّل الخدمات، ويحدث مرة واحدة فقط.
  • يشير الوعد الذي تم تمريره إلى installEvent.waitUntil() إلى مدة التثبيت ونجاحه أو فشله.
  • لن يتلقّى مشغّل الخدمات أحداثًا مثل fetch وpush إلى أن ينتهي من التثبيت بنجاح ويصبح "نشطًا".
  • بشكل تلقائي، لن تمر عمليات جلب الصفحة من خلال مشغّل خدمات ما لم يمر طلب الصفحة نفسه من خلال مشغّل خدمات. لذلك، عليك إعادة تحميل الصفحة للاطّلاع على تأثيرات مشغّل الخدمات.
  • يمكن لـ "clients.claim()" إلغاء هذا الإعداد التلقائي والتحكّم في الصفحات غير الخاضعة للتحكّم.

لنأخذ رمز HTML التالي:

<!DOCTYPE html>
An image will appear here in 3 seconds:
<script>
  navigator.serviceWorker.register('/sw.js')
    .then(reg => console.log('SW registered!', reg))
    .catch(err => console.log('Boo!', err));

  setTimeout(() => {
    const img = new Image();
    img.src = '/dog.svg';
    document.body.appendChild(img);
  }, 3000);
</script>

ويسجّل مشغّل خدمات، ويضيف صورة كلب بعد 3 ثوانٍ.

إليك ملف العامل في الخدمة، sw.js:

self.addEventListener('install', event => {
  console.log('V1 installing…');

  // cache a cat SVG
  event.waitUntil(
    caches.open('static-v1').then(cache => cache.add('/cat.svg'))
  );
});

self.addEventListener('activate', event => {
  console.log('V1 now ready to handle fetches!');
});

self.addEventListener('fetch', event => {
  const url = new URL(event.request.url);

  // serve the cat SVG from the cache if the request is
  // same-origin and the path is '/dog.svg'
  if (url.origin == location.origin && url.pathname == '/dog.svg') {
    event.respondWith(caches.match('/cat.svg'));
  }
});

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

النطاق والتحكّم

النطاق التلقائي لتسجيل مشغّل الخدمات هو ./ بالنسبة إلى عنوان URL للنص البرمجي. هذا يعني أنّه في حال تسجيل مشغّل خدمات على //example.com/foo/bar.js، سيكون نطاقه التلقائي هو //example.com/foo/.

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

التنزيل والتحليل والتنفيذ

يتم تنزيل أول مشغّل خدمات عند طلب .register(). إذا تعذّر تنزيل النص البرمجي أو تحليله أو ظهر خطأ في تنفيذه الأولي، يتم رفض وعد التسجيل ويتم تجاهل مشغّل الخدمات.

تعرض "أدوات مطوّري البرامج في Chrome" الخطأ في وحدة التحكّم وفي قسم مشغّل الخدمات ضمن علامة التبويب "التطبيق":

الخطأ المعروض في علامة التبويب &quot;أدوات مطوّري البرامج&quot; في مشغّل الخدمات

تثبيت

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

يمنحك الحدث install فرصة تخزين كل ما تحتاج إليه مؤقتًا قبل أن تتمكّن من التحكّم في العملاء. يتيح الوعد الذي تمرّره إلى event.waitUntil() للمتصفّح معرفة وقت اكتمال عملية التثبيت وما إذا كانت ناجحة.

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

تفعيل

عندما يصبح مشغّل الخدمات جاهزًا للتحكّم في العملاء ومعالجة الأحداث الوظيفية مثل push وsync، ستتلقّى حدث activate. ولكن هذا لا يعني أنّه سيتم التحكّم في الصفحة التي استدعت .register().

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

clients.claim

يمكنك التحكّم في البرامج غير الخاضعة للتحكّم من خلال استدعاء clients.claim() ضمن مشغّل الخدمات بعد تفعيله.

إليك نسخة مختلفة من العرض التوضيحي أعلاه تستدعي clients.claim() في حدث activate. من المفترض أن تظهر لك قطة في المرة الأولى. أقول "من المفترض"، لأنّ هذا الأمر حسّاس من حيث التوقيت. لن تظهر لك قطة إلا إذا تم تفعيل مشغّل الخدمات وتم تطبيق clients.claim() قبل محاولة تحميل الصورة.

إذا كنت تستخدم مشغّل الخدمات لتحميل الصفحات بشكل مختلف عن طريقة تحميلها عبر الشبكة، قد يسبّب clients.claim() مشاكل، لأنّ مشغّل الخدمات سينتهي به الأمر بالتحكّم في بعض البرامج التي تم تحميلها بدونه.

تحديث مشغّل الخدمات

وباختصار:

  • يتم إجراء تعديل في حال حدوث أي مما يلي:
    • عملية تنقّل إلى صفحة ضمن النطاق
    • أحداث وظيفية، مثل push وsync، ما لم يتم التحقّق من توفّر تحديث خلال آخر 24 ساعة
    • يتم استدعاء .register() فقط في حال تغيير عنوان URL لبرنامج الخدمة. ومع ذلك، يجب تجنُّب تغيير عنوان URL الخاص بالعامل.
  • تتجاهل معظم المتصفّحات، بما في ذلك الإصدار 68 من Chrome والإصدارات الأحدث، تلقائيًا عناوين التخزين المؤقت عند البحث عن تحديثات لملف برمجي مسجَّل لمشغّل الخدمات. ولا تزال تلتزم برؤوس التخزين المؤقت عند جلب الموارد التي تم تحميلها داخل مشغّل خدمات من خلال importScripts(). يمكنك إلغاء هذا الإعداد التلقائي من خلال ضبط الخيار updateViaCache عند تسجيل مشغّل الخدمات.
  • يُعتبر مشغّل الخدمات محدَّثًا إذا كان مختلفًا في البايت عن المشغّل الذي يتضمّنه المتصفّح حاليًا. (نعمل على توسيع نطاق هذه الميزة لتشمل أيضًا النصوص البرمجية أو الوحدات التي تم استيرادها).
  • يتم تشغيل مشغّل الخدمات المحدَّث إلى جانب المشغّل الحالي، ويحصل على حدث install الخاص به.
  • إذا كان العامل الجديد يتضمّن رمز حالة غير صحيح (على سبيل المثال، 404) أو تعذّر تحليله أو عرض خطأ أثناء التنفيذ أو تم رفضه أثناء التثبيت، يتم تجاهل العامل الجديد، ولكن يظل العامل الحالي نشطًا.
  • بعد التثبيت بنجاح، سيتم wait العامل المحدَّث إلى أن يتحكّم العامل الحالي في صفر من العملاء. (يُرجى العِلم أنّ العملاء يتداخلون أثناء إعادة التحميل).
  • يمنع self.skipWaiting() الانتظار، ما يعني أنّ مشغّل الخدمات يتم تفعيله فور الانتهاء من تثبيته.

لنفترض أنّنا غيّرنا نصّ مشغّل الخدمات البرمجي ليعرض صورة حصان بدلاً من قطة:

const expectedCaches = ['static-v2'];

self.addEventListener('install', event => {
  console.log('V2 installing…');

  // cache a horse SVG into a new cache, static-v2
  event.waitUntil(
    caches.open('static-v2').then(cache => cache.add('/horse.svg'))
  );
});

self.addEventListener('activate', event => {
  // delete any caches that aren't in expectedCaches
  // which will get rid of static-v1
  event.waitUntil(
    caches.keys().then(keys => Promise.all(
      keys.map(key => {
        if (!expectedCaches.includes(key)) {
          return caches.delete(key);
        }
      })
    )).then(() => {
      console.log('V2 now ready to handle fetches!');
    })
  );
});

self.addEventListener('fetch', event => {
  const url = new URL(event.request.url);

  // serve the horse SVG from the cache if the request is
  // same-origin and the path is '/dog.svg'
  if (url.origin == location.origin && url.pathname == '/dog.svg') {
    event.respondWith(caches.match('/horse.svg'));
  }
});

اطّلِع على عرض توضيحي لما سبق. من المفترض أن تظهر لك صورة قطة، وإليك السبب…

تثبيت

يُرجى العِلم أنّني غيّرت اسم ذاكرة التخزين المؤقت من static-v1 إلى static-v2. هذا يعني أنه يمكنني إعداد ذاكرة التخزين المؤقت الجديدة دون الكتابة فوق الأشياء الموجودة في الذاكرة الحالية، والتي لا يزال عامل الخدمة القديم يستخدمها.

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

Waiting

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

إذا شغّلت النسخة التجريبية المعدَّلة، من المفترض أن تظهر لك صورة قطة، لأنّ مشغّل الخدمة V2 لم يتم تفعيله بعد. يمكنك الاطّلاع على مشغّل الخدمات الجديد في انتظار المراجعة في علامة التبويب "التطبيق" ضمن "أدوات مطوري البرامج":

&quot;أدوات مطوّري البرامج&quot; تعرض عامل الخدمة الجديد في وضع الانتظار

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

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

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

تفعيل

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

في العرض التوضيحي أعلاه، أحتفظ بقائمة من ذاكرات التخزين المؤقت التي أتوقع أن تكون موجودة، وفي الحدث activate أتخلص من أي ذاكرة تخزين مؤقت أخرى، ما يؤدي إلى إزالة ذاكرة التخزين المؤقت القديمة static-v1.

إذا مرّرت وعدًا إلى event.waitUntil()، سيتم تخزين الأحداث الوظيفية مؤقتًا (fetch وpush وsync وما إلى ذلك) إلى أن يتم حلّ الوعد. لذلك، عند تنشيط حدث fetch، يكتمل التفعيل بالكامل.

تخطّي مرحلة الانتظار

تعني مرحلة الانتظار أنّك تشغّل إصدارًا واحدًا فقط من موقعك الإلكتروني في كل مرة، ولكن إذا لم تكن بحاجة إلى هذه الميزة، يمكنك تفعيل مشغّل الخدمات الجديد في وقت أقرب من خلال طلب self.skipWaiting().

يؤدي ذلك إلى أن يطرد عامل الخدمة العامل النشط الحالي وينشط نفسه بمجرد دخوله مرحلة الانتظار (أو على الفور إذا كان في مرحلة الانتظار بالفعل). لا يؤدي ذلك إلى تخطّي العامل لعملية التثبيت، بل إلى الانتظار فقط.

لا يهمّ متى تتصل بـ skipWaiting()، طالما أنّ ذلك يتم أثناء الانتظار أو قبله. من الشائع جدًا استدعاؤها في الحدث install:

self.addEventListener('install', event => {
  self.skipWaiting();

  event.waitUntil(
    // caching etc
  );
});

ولكن قد تحتاج إلى استدعائها نتيجة لـ postMessage() إلى مشغّل الخدمات. على سبيل المثال، تريد skipWaiting() بعد تفاعل المستخدم.

إليك عرض توضيحي يستخدم skipWaiting(). من المفترض أن تظهر لك صورة بقرة بدون الحاجة إلى الانتقال إلى صفحة أخرى. مثل clients.claim()، إنّها عملية سباق، لذا لن تظهر لك البقرة إلا إذا جلب مشغّل الخدمات الجديد الصورة وثبّتها وفعّلها قبل أن تحاول الصفحة تحميلها.

تحديثات يدوية

كما ذكرتُ سابقًا، يتحقّق المتصفّح من التحديثات تلقائيًا بعد عمليات التنقّل والأحداث الوظيفية، ولكن يمكنك أيضًا تفعيلها يدويًا:

navigator.serviceWorker.register('/sw.js').then(reg => {
  // sometime later…
  reg.update();
});

إذا كنت تتوقّع أن يستخدم المستخدم موقعك الإلكتروني لفترة طويلة بدون إعادة تحميله، يمكنك استدعاء update() على فترات زمنية (مثل كل ساعة).

تجنَّب تغيير عنوان URL الخاص بنص عامل الخدمة البرمجي

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

ويمكن أن يؤدي ذلك إلى مشكلة مثل هذه:

  1. يسجّل index.html sw-v1.js كعامل خدمة.
  2. يخزّن sw-v1.js مؤقتًا index.html ويعرضه ليعمل بلا إنترنت أولاً.
  3. يمكنك تعديل index.html لتسجيل sw-v2.js الجديد واللامع.

إذا نفّذت الإجراءات أعلاه، لن يحصل المستخدم على sw-v2.js أبدًا، لأنّ sw-v1.js يعرض الإصدار القديم من index.html من ذاكرة التخزين المؤقت. لقد وضعت نفسك في موقف تحتاج فيه إلى تحديث مشغّل الخدمات من أجل تحديث مشغّل الخدمات. يا للقرف!

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

تسهيل عملية التطوير

تم إنشاء دورة حياة مشغّل الخدمات مع وضع المستخدم في الاعتبار، ولكن أثناء التطوير، يكون الأمر صعبًا بعض الشيء. لحسن الحظ، هناك بعض الأدوات التي يمكن أن تساعدك:

التحديث عند إعادة التحميل

هذا هو المفضل لدي.

&quot;أدوات مطوّري البرامج&quot; تعرض &quot;التحديث عند إعادة التحميل&quot;

يؤدي ذلك إلى تغيير مراحل النشاط لتكون مناسبة للمطوّرين. سيؤدي كل تنقّل إلى:

  1. أعِد جلب مشغّل الخدمات.
  2. ثبِّته كإصدار جديد حتى إذا كان متطابقًا من حيث البايت، ما يعني تشغيل حدث install وتحديث ذاكرة التخزين المؤقت.
  3. تخطّي مرحلة الانتظار لتفعيل مشغّل الخدمات الجديد
  4. انتقِل إلى الصفحة.

هذا يعني أنّك ستتلقّى التحديثات في كل عملية تنقّل (بما في ذلك إعادة التحميل) بدون الحاجة إلى إعادة التحميل مرتين أو إغلاق علامة التبويب.

تخطّي الانتظار

أدوات مطوّري البرامج تعرض الخيار &quot;تخطّي الانتظار&quot;

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

Shift-reload

إذا فرضت إعادة تحميل الصفحة (shift-reload)، يتم تجاوز مشغّل الخدمات بالكامل. وستكون غير خاضعة للرقابة. هذه الميزة مضمّنة في المواصفات، لذا فهي تعمل في المتصفحات الأخرى التي تتيح استخدام مشغّل الخدمات.

التعامل مع التعديلات

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

لذا، لإتاحة أكبر عدد ممكن من الأنماط، يمكن تتبّع دورة التحديث بأكملها:

navigator.serviceWorker.register('/sw.js').then(reg => {
  reg.installing; // the installing worker, or undefined
  reg.waiting; // the waiting worker, or undefined
  reg.active; // the active worker, or undefined

  reg.addEventListener('updatefound', () => {
    // A wild service worker has appeared in reg.installing!
    const newWorker = reg.installing;

    newWorker.state;
    // "installing" - the install event has fired, but not yet complete
    // "installed"  - install complete
    // "activating" - the activate event has fired, but not yet complete
    // "activated"  - fully active
    // "redundant"  - discarded. Either failed install, or it's been
    //                replaced by a newer version

    newWorker.addEventListener('statechange', () => {
      // newWorker.state has changed
    });
  });
});

navigator.serviceWorker.addEventListener('controllerchange', () => {
  // This fires when the service worker controlling this page
  // changes, eg a new worker has skipped waiting and become
  // the new active worker.
});

دورة الحياة تستمر إلى الأبد

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