Lorixen.
AR

لوحة الطلبات تطبع مرتين من تبويبين؟ Web Locks في المتصفح

باختصار: إذا كانت لوحة الطلبات في مطعمك أو محلك تُفتح في أكثر من تبويب على جهاز الكاشير، فقد تطبع الطلب مرتين، أو ترسل التنبيه مرتين، أو تزامن البيانات من التبويبين معاً. واجهة Web Locks في المتصفح تحل هذا من جهة الواجهة: يطلب كل تبويب «قفلاً» باسم تختاره، مثل print-orders، ولا يحصل عليه إلا تبويب واحد في الوقت نفسه، والبقية تنتظر أو تتخطى. تصفها MDN بأنها متاحة على نطاق واسع في المتصفحات. لكنها تنسّق بين تبويبات المتصفح نفسه فقط، فلا تغني عن منع التكرار في الخادم إذا كان هناك أكثر من جهاز.

المشكلة كما يراها صاحب المطعم

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

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

لماذا لا يكفي أن تقول للموظف «افتح تبويباً واحداً»

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

الأفضل أن يكون التطبيق نفسه قادراً على التنسيق: «إن كان تبويب آخر يتولى الطباعة، فلا تطبع».

ما الذي تقدمه Web Locks

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

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

كيف يعمل الطلب

نقطة الدخول هي navigator.locks.request، وتأخذ اسم القفل، وخيارات اختيارية، ودالة تُستدعى عند منح القفل. توضح MDN أن القفل يُطلق تلقائياً عندما تنتهي الدالة، ولذلك تكون الدالة عادة غير متزامنة، فيبقى القفل محجوزاً حتى ينتهي العمل كله.

وأثناء احتجاز القفل، تُوضع طلبات القفل نفسه من التبويبات الأخرى في طابور، ويُمنح لأول طلب في الطابور عندما يُطلق.

الخيارات التي تهمك

تذكر MDN عدة خيارات عند طلب القفل:

  • mode: الافتراضي exclusive، أي حامل واحد فقط. ويمكن طلب shared فيحصل عدة طالبين على القفل معاً، وهذا مفيد لنمط القراءة والكتابة.
  • ifAvailable: إن حُدد، يفشل الطلب فوراً إذا لم يمكن منح القفل دون انتظار، وتُستدعى الدالة بقيمة null. هذا الخيار هو الأنسب لمشكلة الطباعة: التبويب الثاني لا ينتظر، بل يعرف أن غيره يتولى الأمر.
  • steal: يطلق أي قفل محجوز بالاسم نفسه ويمنح الطلب فوراً. استخدمه بحذر، فهو يقطع على التبويب الآخر عمله.
  • signal: يسمح بإلغاء طلب القفل، ويمكن استخدامه لوضع مهلة.

مثال توضيحي لتبويب واحد يطبع

مثال توضيحي: كل تبويب يحاول أن يصبح «مسؤول الطباعة». الأول يحصل على القفل ويحتفظ به ما دام مفتوحاً، والبقية تعرض رسالة.

navigator.locks.request('kitchen-printer', { ifAvailable: true }, async (lock) => {
  if (!lock) {
    showBanner('لوحة الطلبات مفتوحة في تبويب آخر، والطباعة تتم من هناك.');
    return;
  }
  showBanner('هذا التبويب مسؤول عن طباعة الطلبات.');
  await runPrintLoop();
});

الدالة runPrintLoop تبقى تعمل ما دام التبويب مفتوحاً، فيبقى القفل محجوزاً. عندما يُغلق التبويب، يُطلق القفل، ويمكن لتبويب آخر عند إعادة تحميله أن يتولى المهمة.

انتبه إلى الأقفال المتداخلة

تحذّر MDN من حالة الجمود deadlock: عندما يحتفظ تبويب بقفل ويطلب آخر، بينما يحتفظ تبويب ثانٍ بالآخر ويطلب الأول، فلا يتقدم أي منهما. وتذكر أن من طرق تجنبها ألا تتداخل طلبات الأقفال. في تطبيق محل صغير، القاعدة البسيطة تكفي: قفل واحد لكل مهمة، ولا تطلب قفلاً داخل آخر.

وللتشخيص، توضح MDN أن navigator.locks.query تعطي لقطة من حالة الأقفال المحجوزة والمطلوبة، وهذا يساعد المطور على معرفة لماذا لم يُمنح قفل.

ما لا تحله Web Locks

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

في هذه الحالة يجب أن يقرر الخادم: الطلب يُسلَّم للطباعة مرة واحدة، ويُعلَّم بأنه طُبع، ولا يُعاد إرساله لجهاز آخر. Web Locks تمنع التكرار داخل الجهاز، والخادم يمنعه بين الأجهزة. الحل الكامل يحتاج الاثنين، أو على الأقل الثاني.

اختبار سريع قبل التشغيل في المحل

قبل أن تعتمد الحل في وردية حقيقية، جرّبه بهذه الخطوات على حاسوب الكاشير نفسه:

  1. افتح لوحة الطلبات في تبويب، ثم افتحها في تبويب ثانٍ وثالث.
  2. أرسل طلباً تجريبياً من الموقع، وتأكد أن ورقة واحدة فقط خرجت من الطابعة.
  3. أغلق التبويب الذي كان مسؤولاً عن الطباعة، ثم حدّث تبويباً آخر، وأرسل طلباً ثانياً.
  4. افصل الإنترنت دقيقة ثم أعده، وراقب أن التكرار لم يعد.

أين تفيد أيضاً في محلك

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

أسئلة شائعة

هل يحتاج الموظف إلى فعل أي شيء؟

لا. التنسيق يحدث في الخلفية. يكفي أن تظهر رسالة واضحة في التبويب الثاني تخبره بأن الطباعة تتم من تبويب آخر.

ماذا يحدث إذا تعطل التبويب المسؤول؟

القفل يُطلق عند انتهاء الدالة أو إغلاق التبويب، فيمكن لتبويب آخر أن يتولى المهمة عند إعادة المحاولة أو التحميل.

هل يغني هذا عن منع التكرار في الخادم؟

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

هل تعمل في كل المتصفحات؟

تصفها MDN بأنها متاحة على نطاق واسع. ومع ذلك، افحص وجود navigator.locks قبل استخدامها.

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

المصادر

WhatsAppاحجز مكالمة