انتقل إلى المحتوى
تمايز للتسويق وتطوير المتاجر الإلكترونيةتقنية وتسويقالعودة للمتجر
القائمة

تمايز / معلومات تهمك

كيف تنفذ تحديث Service Worker في تطبيق PWA دون تشغيل نسختين متعارضتين؟

دليل عملي لفهم دورة تحديث Service Worker في تطبيق PWA، وإدارة الانتظار والتفعيل والكاش من دون قطع جلسة المستخدم أو تشغيل نسخ متعارضة.

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

إذا كان متجرك يحتاج تنفيذًا كتطبيق ويب قابل للتثبيت، راجع خدمة إنشاء التطبيقات. ولمراجعة جانب الاسم والأيقونات، اقرأ دليل تحديث Manifest والاسم والأيقونة في PWA.

دورة تحديث Service Worker في تطبيق PWA

يفحص المتصفح ملف Service Worker ويبدأ تثبيت نسخة جديدة عندما يكتشف تغيرًا. بعد نجاح install تدخل النسخة الجديدة عادة حالة waiting ما دامت صفحات تستخدم العامل السابق. ثم تنتقل إلى activate عندما لا تبقى عملاء تحت سيطرة النسخة القديمة أو عندما يفرض التطبيق مسارًا آخر.

يشرح دليل دورة Service Worker على web.dev هذه المراحل وسبب وجودها: منع صفحة واحدة من العمل في الوقت نفسه مع نسختين غير متوافقتين من منطق الموقع. لذلك لا تتعامل مع waiting كخطأ؛ إنها آلية حماية تحتاج تجربة مستخدم واضحة.

خطط توافق الملفات والكاش أولًا

امنح كل إصدار اسم كاش واضحًا، مثل static-v12، واجعل install يخزن الحد الأدنى الضروري فقط. خلال activate احذف الكاشات القديمة التي تخص تطبيقك، مع تجنب حذف مساحات لا تملكها. لا تضع HTML الديناميكي وصفحات السلة والدفع في سياسة كاش ثابتة لمجرد تسريعها.

اجعل ملفات الواجهة تحمل أسماء مبنية على المحتوى عند الإمكان، حتى لا يشير HTML جديد إلى JavaScript قديم. واختبر سيناريو الرجوع إلى الشبكة عندما لا توجد استجابة في الكاش بدل إرجاع ملف غير مناسب لنوع الطلب.

خطوات إطلاق تحديث آمن

  1. ارفع الملفات المتوافقة ثم Service Worker: تأكد أن كل ملف يشير إليه الإصدار الجديد متاح قبل أن يبدأ العامل في تثبيته، ولا تحذف موارد الإصدار السابق فورًا.
  2. اكتشف حالة waiting وأبلغ المستخدم: اعرض رسالة قصيرة مثل «يتوفر تحديث، أعد التحميل بعد حفظ عملك»، خصوصًا إذا كان المستخدم يكتب نموذجًا أو يراجع سلة.
  3. فعّل ثم أعد التحميل مرة واحدة: بعد قبول المستخدم، أرسل رسالة للعامل المنتظر كي يتولى التفعيل، وراقب حدث controllerchange ثم نفذ إعادة تحميل محكومة مع علم يمنع الحلقة.

توضح وثائق MDN عن skipWaiting أن الدالة تجعل العامل المنتظر يصبح نشطًا سريعًا. استخدامها ليس قرارًا تلقائيًا مناسبًا دائمًا؛ يجب التأكد أن الصفحة الحالية تستطيع العمل مع العامل الجديد أو أن التطبيق سيعيد تحميلها فور السيطرة.

متى تستخدم skipWaiting وclients.claim؟

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

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

مثال افتراضي

متجر افتراضي حدّث ملف السلة ومنطق Service Worker. اكتشف التطبيق عاملًا في waiting، لكنه لم يجبر العميل على إعادة التحميل أثناء إدخال العنوان. ظهر شريط تحديث، وعند ضغط المستخدم «تحديث الآن» حفظ التطبيق المسودة محليًا، وأرسل رسالة التفعيل، وانتظر controllerchange، ثم أعاد تحميل الصفحة مرة واحدة.

بعد activate حذف العامل static-v11 فقط، وأبقى بيانات لا تخصه. عاد التطبيق واستعاد مسودة العنوان، ثم طلب بيانات السلة من الخادم. بهذه الطريقة لم تعمل واجهة قديمة مع قواعد كاش جديدة في جلسة غير محكومة.

اختبارات يجب تنفيذها

اختبر أول زيارة، والزيارة بعد تحديث، وفتح نافذتين بإصدارين، والعمل دون اتصال، واتصالًا بطيئًا ينقطع أثناء install. افتح DevTools وتابع حالات Service Worker وCache Storage، ثم تحقق من عدم وجود إعادة تحميل متكررة. جرّب كذلك مستخدمًا يترك التطبيق مفتوحًا ساعات ثم يعود.

قائمة مراجعة قبل النشر

  • [ ] أسماء الكاشات مرتبطة بإصدار ويمكن تنظيفها بأمان.
  • [ ] ملفات الإصدار الجديد متاحة قبل تثبيت العامل.
  • [ ] صفحات السلة والدفع لا تعتمد على HTML قديم ثابت.
  • [ ] التطبيق يكتشف waiting ويشرح التحديث للمستخدم.
  • [ ] skipWaiting مستخدم بقرار واضح وليس تلقائيًا بلا اختبار.
  • [ ] controllerchange لا يسبب حلقة إعادة تحميل.
  • [ ] نوافذ متعددة واتصال بطيء ووضع عدم الاتصال اختُبرت.
  • [ ] توجد طريقة رجوع إذا أخفق الإصدار الجديد.

المراجع والمصادر

محتوى إرشادي أُعد بمساعدة الذكاء الاصطناعي. الأمثلة افتراضية للتوضيح، وليست نتائج لعملاء تمايز.

نسمعك

اكتب سؤالك أو ملاحظتك. يُنشر التعليق بعد المراجعة، ويبقى البريد خاصًا.