زر السلة توقف بعد تفعيل Cloudflare: Rocket Loader والسكربتات
باختصار: إذا فعّلت خيار تسريع في Cloudflare، ثم بدأت بعض أجزاء موقعك تتصرف بغرابة، مثل زر الإضافة إلى السلة الذي لا يستجيب، أو قائمة الجوال التي لا تفتح، أو نموذج الحجز الذي لا يُرسل، أو أداة الدردشة التي اختفت، فقد يكون السبب Rocket Loader. توثيق Cloudflare يشرح أن هذه الميزة تؤجل تحميل كل JavaScript في الموقع إلى ما بعد عرض المحتوى، وينصح صراحة: إذا لاحظت مشاكل في JavaScript أو jQuery، عطّل Rocket Loader وأعد اختبار موقعك. وإذا ثبت أنه السبب، يمكنك استثناء سكربت محدد بالخاصية data-cfasync="false"، أو استثناء صفحة كاملة بقاعدة إعدادات.
كيف تظهر المشكلة؟
متجر أدوات منزلية في عمّان نقل موقعه إلى Cloudflare لتحسين السرعة. في لوحة التحكم، فعّل أحد الموظفين كل خيارات التسريع المتاحة. في اليوم التالي، اشتكى زبائن أن زر «أضف إلى السلة» في بعض الصفحات لا يفعل شيئاً، وأن قائمة الأقسام على الهاتف لا تنفتح. وعلى الحاسوب، كانت الأمور تعمل أحياناً وتفشل أحياناً.
المطور فحص الكود ولم يجد خطأ، لأن الكود نفسه لم يتغير. الذي تغير هو طريقة تحميله. هذا مثال توضيحي لحالة شائعة بعد تفعيل خيارات التسريع دفعة واحدة.
ماذا يفعل Rocket Loader بالضبط؟
بحسب توثيق Cloudflare، Rocket Loader يعطي الأولوية لمحتوى موقعك، من نصوص وصور وخطوط، بتأجيل تحميل كل JavaScript إلى ما بعد العرض. ويسمي هذا النوع من التحميل التحميل غير المتزامن، ويذكر أنه يؤدي إلى عرض محتوى الصفحة أبكر. ويضيف أن الميزة تتعامل مع السكربتات المضمنة في الصفحة والخارجية، مع الحفاظ على ترتيب التنفيذ، وأن Cloudflare تكتشف المتصفحات غير المتوافقة وتعطّل الميزة لها.
ويذكر التوثيق أن الميزة متاحة في كل خطط Cloudflare، من المجانية إلى خطط الشركات. لذلك قد تجدها مفعلة في موقع صغير على الخطة المجانية.
لماذا قد يكسر هذا بعض السكربتات؟
الفكرة ممتازة نظرياً: يرى الزائر المحتوى أسرع، ثم تعمل السكربتات. لكن بعض السكربتات كُتبت على افتراض أنها تعمل في لحظة معينة أثناء تحميل الصفحة، أو أن سكربتاً آخر محمّل قبلها. عندما يتغير التوقيت، قد يبحث سكربت عن مكتبة لم تُحمّل بعد، أو عن حدث «اكتمل التحميل» مرّ قبل أن يبدأ.
المرشحون المعتادون في المتاجر والمواقع:
- سكربتات تعتمد على jQuery، خصوصاً القديمة منها في القوالب والإضافات.
- أدوات الدردشة والدعم المضمنة.
- أكواد بوابات الدفع ونماذج الحجز من جهات خارجية.
- أكواد التتبع والإعلانات التي يجب أن تعمل مبكراً.
التوثيق نفسه يذكر مشاكل JavaScript وjQuery تحديداً كإشارة لتعطيل الميزة والاختبار.
الخطوة الأولى: تأكد أنه السبب
لا تفترض. التوثيق يقترح التعطيل وإعادة الاختبار:
- في لوحة Cloudflare، اذهب إلى صفحة إعدادات السرعة، ثم قسم تحسين المحتوى.
- أطفئ مفتاح Rocket Loader.
- امسح الذاكرة المؤقتة في متصفحك أو استخدم نافذة خاصة.
- جرّب الأجزاء التي كانت تتعطل: زر السلة، والقائمة، والنموذج، والدردشة.
إذا عادت كلها للعمل، فقد وجدت السبب. إذا بقيت معطلة، فالمشكلة في مكان آخر، وأعد تفعيل الميزة إن أردت.
الخطوة الثانية: استثنِ بدقة بدل التعطيل الكامل
إذا كان Rocket Loader يحسّن سرعة موقعك عموماً، ومشكلته في سكربت أو صفحة واحدة فقط، فلديك خياران في التوثيق:
استثناء سكربت محدد: يذكر التوثيق أنه يمكن جعل Rocket Loader يتجاهل سكربتاً معيناً بإضافة الخاصية data-cfasync="false" إلى وسم السكربت، وأن الميزة تستمر في تحسين بقية السكربتات في الصفحة.
لكن انتبه لشرطين يذكرهما التوثيق:
- إضافة هذه الخاصية من داخل JavaScript لا تعمل. يجب أن تكون في وسم السكربت نفسه في الصفحة.
- إذا كان السكربت المستثنى يعتمد على سكربتات أخرى في الصفحة، فيجب أن تحمل تلك الاعتماديات الخاصية نفسها أيضاً. مثلاً: إذا استثنيت سكربت الدردشة وهو يحتاج jQuery، فاستثنِ jQuery أيضاً.
استثناء صفحة كاملة: يقول التوثيق إنه إذا كان Rocket Loader يؤثر في صفحة محددة فقط، استخدم قاعدة إعدادات لاستثناء تلك الصفحة برابطها. هذا مناسب مثلاً لصفحة الدفع أو صفحة الحجز التي تعتمد على أكواد خارجية كثيرة.
ويذكر التوثيق أيضاً أنه لاستخدام الميزة على نطاقات فرعية محددة بدل النطاق كله، يمكن استخدام قاعدة إعدادات.
كيف يكتشف المطور السكربت المتأثر؟
إذا أكد التعطيل أن Rocket Loader هو السبب، فالخطوة التالية معرفة أي سكربت تحديداً يتأثر، بدل استثناء كل شيء:
- وحدة تحكم المتصفح: يفتح المطور أدوات المطور في المتصفح، ويعيد تفعيل الميزة، ثم يجرب الزر المعطل. الأخطاء التي تظهر غالباً تذكر اسم الدالة أو المكتبة غير المعرّفة، مثل رسالة تقول إن jQuery غير معرّف.
- ترتيب السكربتات: يراجع أي سكربتات في الصفحة تعتمد على غيرها. التوثيق يذكر أن الاعتماديات يجب أن تُستثنى مع السكربت.
- السكربتات الخارجية: أدوات الدردشة وبوابات الدفع تُضاف عادة بكود منسوخ من مزودها. هذه أول ما يُفحص.
ابدأ باستثناء أقل عدد ممكن من السكربتات، ثم اختبر. كل سكربت يُستثنى يعود ليُحمّل بالطريقة العادية، فلا تستثنِ الجميع وتفقد الفائدة.
إذا كان لديك سياسة أمان للمحتوى
نقطة تقنية يجب أن يعرفها المطور: التوثيق يذكر أنه إذا كان لنطاقك سياسة أمان محتوى، فستحتاج إلى تحديث الترويسات لدعم Rocket Loader. إذا كان موقعك يستخدم هذه السياسة، وظهرت أخطاء في وحدة تحكم المتصفح عن سكربتات محظورة بعد تفعيل الميزة، فهذا سبب محتمل.
رسائل التحقق من HTML ليست مشكلة بحد ذاتها
قد يلاحظ المطور أن أدوات التحقق من صحة HTML تُظهر أخطاء بعد تفعيل الميزة. التوثيق يوضح أن بعض الميزات الاختيارية في Cloudflare، ومنها Rocket Loader، تستخدم وسوماً غير قياسية تفشل في التحقق الصارم، ويذكر أن هذه الإخفاقات لا ترتبط بمشاكل لزوار موقعك. فلا تعطّل الميزة لهذا السبب وحده.
قاعدة عامة لخيارات التسريع
خطأ متجر الأدوات المنزلية لم يكن تفعيل Rocket Loader تحديداً، بل تفعيل كل الخيارات دفعة واحدة دون اختبار. الطريقة الأسلم:
- فعّل خياراً واحداً في كل مرة.
- اختبر رحلة الزبون الكاملة: التصفح، والإضافة إلى السلة، والدفع، والنماذج.
- اختبر على الهاتف والحاسوب.
- سجّل ما فعّلته ومتى، كي تعرف ما الذي تغير إذا ظهرت مشكلة بعد أيام.
أسئلة شائعة
فعّلت Cloudflare وصار زر السلة ما يشتغل، ليش؟
قد يكون Rocket Loader، لأنه يؤجل تحميل JavaScript فيغير توقيت تشغيل السكربتات. عطّله واختبر للتأكد.
كيف أخلي Rocket Loader يتجاهل سكربت معين؟
أضف data-cfasync="false" إلى وسم السكربت مباشرة، ومع أي سكربت يعتمد عليه، مثل jQuery.
المشكلة بصفحة الدفع بس، شو أعمل؟
استخدم قاعدة إعدادات في Cloudflare لاستثناء تلك الصفحة برابطها، وأبقِ الميزة لبقية الموقع.
أدوات التحقق من HTML بتطلع أخطاء، هل هذا خطر؟
بحسب Cloudflare، هذه الإخفاقات لا ترتبط بمشاكل للزوار، فلا تعطّل الميزة لهذا السبب وحده.
إذا تعطلت أجزاء من موقعك بعد تفعيل خيارات التسريع، تواصل معنا ونحدد السبب معك.