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

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

كيف تدير مزامنة الطلبات دون اتصال في PWA بأمان؟

شرح عملي لبناء طابور طلبات آمن في تطبيق PWA، ومنع التكرار، وإظهار الحالة للمستخدم، واختبار الإرسال بعد عودة الاتصال.

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

توضح وثائق Service Workers في web.dev أن العامل الخدمي يعمل بدورة حياة مستقلة وأن حالته الموجودة في الذاكرة قد لا تبقى، لذا ينبغي حفظ ما يلزم في تخزين دائم. ويعرض دليل تطبيقات عدم الاتصال استراتيجيات التعامل مع الطلبات والمزامنة في الخلفية، مع ضرورة اختيار الاستراتيجية وفق نوع البيانات وطبيعة العملية.

ما الطلبات المناسبة للمزامنة المؤجلة؟

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

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

مزامنة الطلبات دون اتصال في PWA خلال ثلاث خطوات

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

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

كيف تمنع تكرار الطلب أو الدفع؟

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

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

مثال افتراضي

عميل يكتب ملاحظة على طلبه ثم ينقطع الاتصال قبل الإرسال. يسجل التطبيق الملاحظة محليًا بمعرّف note-847 ويعرض «بانتظار الاتصال». عند عودة الشبكة يرسل العامل الخدمي الطلب مع المفتاح نفسه. يصل الرد لكن ينقطع الاتصال مرة أخرى قبل استلامه، فتحدث محاولة ثانية؛ يتعرف الخادم إلى المفتاح ويعيد نتيجة العملية السابقة بدل إضافة الملاحظة مرتين. هذا «مثال افتراضي» يوضح منع الازدواج، ولا يعني أن كل عمليات المتجر مناسبة للمزامنة.

ماذا يحدث في المتصفحات غير الداعمة؟

افحص دعم الميزة قبل التسجيل. احتفظ بمسار بديل يحاول إعادة الطابور عند تشغيل العامل الخدمي، لكنه قد يكون أقل سرعة من المزامنة الأصلية. لذلك ضع زر «إعادة المحاولة» في الواجهة، واعرض عدد العمليات المعلقة، ولا تَعِد المستخدم بزمن تنفيذ محدد.

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

المراقبة والخصوصية

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

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

قائمة مراجعة قبل الإطلاق

  • [ ] الطلبات المؤجلة محددة وليست كل طلبات الموقع.
  • [ ] لكل عملية مفتاح منع تكرار يفهمه الخادم.
  • [ ] الحالة محفوظة في تخزين دائم، لا في الذاكرة فقط.
  • [ ] الواجهة تفرق بين «معلق» و«تم بنجاح».
  • [ ] توجد حدود للمحاولات ومدة الاحتفاظ والطابور.
  • [ ] الأخطاء الدائمة لا يعاد إرسالها بلا نهاية.
  • [ ] الدفع والبيانات الحساسة مستثناة أو محمية بتصميم خادمي مناسب.
  • [ ] اختُبر الإغلاق وانتهاء الجلسة والمتصفحات غير الداعمة.
  • [ ] يستطيع المستخدم رؤية العملية المعلقة وإلغاؤها.

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

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

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

نسمعك

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