Lorixen.
AR

صفحة الحجز تنتظر ملفاتها واحداً تلو الآخر؟ modulepreload

باختصار: إذا بنيت صفحة حجز أو طلب لعيادتك أو مطعمك في الأردن بجافاسكربت حديثة مقسمة إلى وحدات (modules)، فقد تلاحظ أن الصفحة تبقى فارغة أو زر "احجز" لا يستجيب لثوانٍ على شبكة الجوال، رغم أن حجم الملفات ليس كبيراً. السبب غالباً سلسلة انتظار: المتصفح يحمّل الملف الرئيسي، ثم يكتشف أنه يستورد ملفاً ثانياً، فيحمله، ثم يكتشف ثالثاً، وهكذا. الوسم link rel="modulepreload" يخبر المتصفح مبكراً بالوحدات التي ستحتاجها الصفحة، فيجلبها بالتوازي ويجهزها للتنفيذ. في هذا المقال نشرح كيف تكتشف سلسلة الانتظار، ومتى تضيف modulepreload يدوياً، وما الذي تفعله أدوات البناء تلقائياً، ولماذا لا تحمّل كل شيء مسبقاً.

ما هي سلسلة الانتظار في الوحدات

عندما تكتب صفحتك بوحدات جافاسكربت، يحمّل HTML ملفاً واحداً عبر script type="module"، وهذا الملف يستورد ملفات أخرى بعبارة import. توضح MDN في صفحة modulepreload، بمثال من ثلاثة ملفات، أن المتصفح لا يكتشف الوحدتين التابعتين ولا يبدأ جلبهما إلا بعد أن ينتهي تحميل الملف الرئيسي.

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

ما الذي يفعله modulepreload

بحسب MDN، الكلمة modulepreload في سمة rel لعنصر link توفر طريقة تصريحية لجلب سكربت وحدة مبكراً، وتحليله وترجمته، وتخزينه في خريطة الوحدات الخاصة بالمستند لتنفيذه لاحقاً. وتذكر MDN أن التحميل المسبق يسمح بتنزيل الوحدات وتوابعها مبكراً، لأنه يتيح للصفحة جلب الوحدات بالتوازي بدل جلبها تتابعياً كلما اكتُشفت التوابع.

وتصف MDN الميزة بأنها Baseline متاحة على نطاق واسع، وتعمل عبر المتصفحات منذ سبتمبر 2023.

الفرق بينه وبين preload العادي

تشرح MDN أن rel="preload" يحمّل الملف فقط ويخزنه في الذاكرة المؤقتة، بينما modulepreload يجلب الوحدة ويحللها ويترجمها ويضع النتيجة في خريطة الوحدات لتكون جاهزة للتنفيذ. لذلك للوحدات تحديداً، modulepreload هو الخيار المناسب.

وهناك تفاصيل تقنية تذكرها MDN: طلب modulepreload يكون دائماً بنمط cors، وسمة crossorigin تحدد إرسال بيانات الاعتماد؛ إن كانت anonymous أو فارغة، وهي الافتراضية، تُرسل ملفات تعريف الارتباط فقط للطلبات من الأصل نفسه. والسمة as اختيارية وافتراضيها script.

مثال توضيحي: صفحة حجز موعد

مثال توضيحي لصفحة حجز في عيادة أسنان في الزرقاء، ملفها الرئيسي booking.js يستورد التقويم، والتقويم يستورد أدوات التاريخ:

<link rel="modulepreload" href="/js/booking.js">
<link rel="modulepreload" href="/js/calendar.js">
<link rel="modulepreload" href="/js/date-utils.js">
<script type="module" src="/js/booking.js"></script>

بهذا يبدأ المتصفح جلب الملفات الثلاثة معاً منذ قراءة رأس الصفحة، بدل انتظار كل ملف ليكتشف الذي بعده.

لماذا تكتب التوابع بنفسك

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

أدوات البناء تفعل جزءاً من هذا

إن كان مشروعك مبنياً بأداة مثل Vite، فتوثيقها يذكر أنها تولد تلقائياً وسوم link rel="modulepreload" للأجزاء الرئيسية وما تستورده مباشرة في ملف HTML الناتج عن البناء. ويشرح التوثيق أيضاً حالة الاستيراد الديناميكي: عندما يُطلب جزء غير متزامن يعتمد على جزء مشترك، فالوضع غير المحسن يحتاج رحلة إضافية لاكتشاف الجزء المشترك، بينما تعيد Vite كتابة الاستيراد الديناميكي بخطوة تحميل مسبق تجلب الجزأين بالتوازي.

الخلاصة العملية: قبل أن تضيف وسوماً يدوياً، افتح ملف HTML الناتج عن البناء وانظر هل الوسوم موجودة. المشكلة غالباً تظهر في مشاريع تُخدم فيها الوحدات دون أداة بناء، أو في قوالب تولد HTML من الخادم ولا تنقل وسوم البناء، أو في سكربتات أضيفت لاحقاً خارج نظام البناء.

لا تحمّل كل شيء مسبقاً

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

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

كيف تكتشف المشكلة في موقعك

  1. افتح صفحة الحجز أو الطلب بأدوات المطور، وفعّل محاكاة شبكة جوال بطيئة.
  2. في لوحة الشبكة، صفّ الطلبات حسب نوع script وراقب مخطط التوقيت.
  3. إن رأيت ملفات جافاسكربت تبدأ واحداً بعد آخر كالدرج، فهذه سلسلة انتظار.
  4. أضف modulepreload للملفات في المسار الحرج وأعد التجربة.
  5. قارن متى يصبح زر الحجز قابلاً للضغط قبل التعديل وبعده.

أخطاء شائعة

  • تحميل مسبق لملف بمسار مختلف عن مسار الاستيراد الفعلي، كأن يكون فيه رقم إصدار مختلف، فيُجلب الملف مرتين.
  • نسيان crossorigin حين تكون الوحدات على نطاق آخر يحتاج بيانات اعتماد.
  • استخدام preload العادي للوحدات بدل modulepreload.
  • إضافة عشرات الوسوم لكل ملفات التطبيق، فتنافس الصور والخطوط المهمة على الشبكة.
  • تعديل HTML الناتج يدوياً ثم يمحو البناء التالي التعديل.

ماذا تطلب من المطور أو الشركة التي بنت موقعك

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

أين تفيد في الأعمال الأردنية

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

أسئلة شائعة

هل يكفي modulepreload لتسريع صفحة الحجز؟

يحل مشكلة سلسلة الانتظار في الوحدات فقط. حجم الملفات وسرعة الخادم والصور والخطوط تحتاج معالجة منفصلة.

هل أحتاجه إن كنت أستخدم Vite؟

توثيق Vite يذكر أنها تولد هذه الوسوم تلقائياً لنقاط الدخول وما تستورده مباشرة. تحقق من HTML الناتج قبل الإضافة اليدوية.

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

تصفه MDN بأنه Baseline متاح على نطاق واسع منذ سبتمبر 2023، لكن جلب التوابع تلقائياً يختلف بين المتصفحات.

كيف أعرف أن التعديل نجح؟

افتح لوحة الشبكة على محاكاة جوال بطيء: يجب أن تبدأ ملفات الوحدات المهمة معاً تقريباً بدل أن تظهر كدرج متتابع، وأن يصبح زر الحجز جاهزاً أبكر.

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

المصادر

WhatsAppاحجز مكالمة