تسمح معالجات البروتوكولات في PWA للتطبيق المثبت بفتح روابط من نوع محدد، مثل mailto أو بروتوكول مخصص يبدأ بـ web+. هذه الميزة مفيدة لتوجيه رابط طلب أو منتج إلى شاشة داخل التطبيق، لكنها محدودة الدعم وتعتمد على المتصفح ونظام التشغيل وموافقة المستخدم.
توضح مرجعية protocol_handlers في بيان التطبيق شكل التعريف ونطاق رابط المعالجة. وتشرح مرجعية registerProtocolHandler شروط HTTPS وتطابق الأصل ووجود الرمز %s والاحتمال أن يطلب المتصفح تأكيد المستخدم.
متى تستخدم معالج بروتوكول؟
استخدمه عندما يوجد رابط ذو معنى يمكن فتحه داخل تطبيقك، مثل web+store:product/123. لا تستخدمه بدل الروابط العادية لكل تنقل؛ روابط HTTPS المدعومة على الويب أبسط وأوسع توافقًا.
قبل التنفيذ حدد سلوكًا بديلًا لمن لا يملك التطبيق أو يستخدم متصفحًا غير داعم. ميزة ليست Baseline في جميع المتصفحات، لذلك لا تجعل الشراء أو الدعم يعتمد عليها وحدها.
يمكن إعداد تجربة التثبيت والمسارات ضمن خدمة تصميم تطبيق متجر إلكتروني، مع اختبار كل جهاز مستهدف فعليًا.
كيف تضبط معالجات البروتوكولات في PWA؟
في manifest أضف protocol_handlers بعناصر تحتوي protocol وurl. يجب أن يكون رابط المعالجة داخل scope وأن يضم %s ليُستبدل بالرابط الأصلي. للبروتوكول المخصص استخدم اسمًا يبدأ بـ web+ وبأحرف صغيرة وفق القيود.
- صمم بروتوكولًا ومسارًا لا يكشف بيانات حساسة داخل الرابط.
- أضف المعالج في manifest أو استخدم API المسموح، ثم ثبّت التطبيق من جديد عند الحاجة.
- اختبر رابطًا صحيحًا وآخر غير صالح، وتأكد من وجود صفحة بديلة على الويب.
ميزة Web Share Target قريبة في الفكرة لكنها تستقبل محتوى من قائمة المشاركة. يشرح مقال إضافة Web Share Target لتطبيق PWA الفرق في مسار البيانات والحقول المستلمة.
كيف تعالج قيمة %s بأمان؟
القيمة المستلمة URL مشفّر يمثل الرابط الأصلي. لا تستخدمه مباشرة في HTML ولا تمرره إلى إعادة توجيه مفتوحة. فك الترميز وفق الحاجة، ثم تحقق من scheme والبنية والقيم المسموحة قبل تحديد الشاشة.
إذا كان البروتوكول يحتوي معرف منتج، اسمح بالصيغة المتوقعة فقط واستخرج المعرف. ارفض القيم الطويلة أو غير المعروفة. لا تضع بريدًا أو رمز دخول أو بيانات دفع في الرابط، لأن الروابط قد تُسجل في التاريخ أو السجلات.
اجعل مسار المعالجة يعمل حتى عندما يفتح في تبويب عادي. بذلك يحصل المستخدم على تفسير وخيار متابعة بدل صفحة خطأ.
مثال افتراضي
مثال افتراضي: متجر يعرّف web+tamayuz لفتح صفحة منتج. يرسل الرابط web+tamayuz:product/42، ويستلمه التطبيق في /open?target=%s. كان الكود يعيد التوجيه إلى أي قيمة بعد فكها، فأصبح قابلاً لإعادة توجيه غير مرغوبة.
يقيد الفريق القيم إلى product ومعرف رقمي، ويتحقق من وجود المنتج، ويعرض رسالة إذا كان الرابط قديمًا. يختبر على متصفح داعم وغير داعم، ويترك رابط HTTPS عاديًا بجوار الرابط المخصص.
كيف تختبر التثبيت والتسجيل؟
امسح نسخة التطبيق القديمة أو حدّث manifest ثم أعد التثبيت إذا لم يلتقط النظام التغيير. راجع DevTools للتأكد من قراءة البيان بلا أخطاء. اختبر فتح الرابط من صفحة أخرى ومن تطبيق أصلي إن أمكن، لأن السلوك يختلف باختلاف النظام.
لا تفترض أن نجاح التسجيل يجعل التطبيق الخيار الافتراضي؛ المستخدم أو النظام قد يطلبان تأكيدًا أو يعرضان قائمة تطبيقات. احترم قرار المستخدم ولا تحاول تجاوز واجهة الاختيار.
قائمة مراجعة
- [ ] الموقع يعمل عبر HTTPS.
- [ ] البروتوكول مسموح وصيغته صحيحة.
- [ ] رابط المعالجة داخل scope.
- [ ] المسار يحتوي %s.
- [ ] القيم المستلمة تُتحقق قبل الاستخدام.
- [ ] لا توجد بيانات حساسة في الرابط.
- [ ] يوجد بديل عبر HTTPS.
- [ ] التطبيق اختُبر بعد إعادة التثبيت.
- [ ] جرى اختبار متصفح غير داعم.
- [ ] لم يُفترض أن التطبيق سيصبح افتراضيًا تلقائيًا.
الميزة تحسن التكامل على الأجهزة الداعمة، لكنها لا تجعل PWA تطبيقًا أصليًا كاملًا ولا تضمن دعم جميع المتصفحات.
المراجع والمصادر
محتوى إرشادي أُعد بمساعدة الذكاء الاصطناعي. الأمثلة افتراضية للتوضيح، وليست نتائج لعملاء تمايز.
تمايز للتسويق وتطوير المتاجر الإلكترونيةتقنية وتسويق
نسمعك