البحث الفوري يعرض نتائج كلمة قديمة؟ الحل بـ AbortController
باختصار: في البحث الفوري داخل متجرك، يكتب الزبون «بندول» حرفاً حرفاً، فيرسل الموقع طلباً مع كل حرف. أحياناً يصل رد الطلب القديم بعد رد الطلب الجديد، فتظهر نتائج كلمة «بن» بينما الخانة مكتوب فيها «بندول». الحل الأساسي هو إلغاء الطلب السابق قبل إرسال الجديد باستخدام AbortController، وهي ميزة متاحة على نطاق واسع في المتصفحات منذ 2019 بحسب MDN، مع انتظار قصير قبل الإرسال وتجاهل الردود التي لم تعد مطلوبة.
كيف يحدث الخطأ بالضبط؟
البحث الفوري، أو ما يسميه البعض البحث أثناء الكتابة، يعمل غالباً بهذه الطريقة: كل مرة تتغير فيها الخانة، يرسل الموقع طلب fetch إلى الخادم ويعرض النتائج عندما يصل الرد. المشكلة أن الطلبات لا ترجع بالترتيب الذي أُرسلت به. طلب «بن» قد يكون أبطأ لأن نتائجه كثيرة، وطلب «بندول» أسرع لأن نتائجه قليلة. فيصل رد «بندول» أولاً ويظهر صحيحاً، ثم يصل رد «بن» بعده بلحظة ويكتب فوقه.
الزبون يرى خانة فيها كلمة، وتحتها نتائج لا علاقة لها بها: قهوة وبن بدل دواء الصداع. يظن أن البحث لا يعمل، أو أن الصنف غير موجود، فيغلق الصفحة. وهذا الخطأ أصعب في الاكتشاف لأنه لا يظهر على شبكة المكتب السريعة، بل على جوال الزبون عندما تكون الشبكة متذبذبة.
الفكرة: طلب واحد حي في كل لحظة
ما يحتاجه البحث الفوري هو قاعدة بسيطة: الطلب الوحيد الذي يهمنا هو الأخير. كل ما قبله يجب أن يُلغى أو يُتجاهل. توفر المتصفحات لذلك AbortController: كائن تنشئه قبل الطلب، وتمرر إشارته signal إلى fetch، ثم تستدعي abort() عندما تريد الإلغاء. وتوضح MDN أن استدعاء abort() يجعل وعد fetch يُرفض باستثناء اسمه AbortError، وأن الإلغاء يمكن أن يوقف أيضاً قراءة جسم الرد إن كان الطلب قد بدأ يصل.
مثال على الكود
let controller;
async function search(term) {
if (controller) controller.abort();
controller = new AbortController();
try {
const res = await fetch('/api/search?q=' + encodeURIComponent(term), {
signal: controller.signal
});
const data = await res.json();
renderResults(data);
} catch (err) {
if (err.name === 'AbortError') return;
showSearchError();
}
}
ثلاث نقاط مهمة هنا. الأولى أن الطلب السابق يُلغى قبل إنشاء الجديد. الثانية أن خطأ AbortError ليس خطأ حقيقياً يستحق رسالة للزبون، فنتجاهله بصمت. الثالثة أن النص يُرمّز بـ encodeURIComponent حتى تصل الكلمات العربية والمسافات سليمة إلى الخادم.
أضف انتظاراً قصيراً قبل الإرسال
الإلغاء يحل مشكلة الترتيب، لكنه لا يمنع إرسال طلب مع كل حرف. الأفضل أن ينتظر الموقع لحظة قصيرة بعد آخر ضغطة قبل الإرسال، فإذا كتب الزبون حرفاً جديداً خلالها أُعيد العداد. هذه الطريقة تعرف بالـ debounce، وتخفف الحمل على الخادم وعلى باقة إنترنت الزبون. اختر مدة الانتظار بالتجربة: قصيرة بحيث لا يشعر الزبون بالتأخير، وطويلة بما يكفي لتجميع الحروف المتتالية.
ويمكن أيضاً ألا يبدأ البحث إلا بعد حرفين أو ثلاثة، لأن نتائج حرف واحد في العربية واسعة جداً ولا تفيد أحداً.
ماذا لو كانت مكتبتك لا تدعم الإلغاء؟
بعض مكتبات الطلبات أو الأكواد القديمة لا تمرر signal. هنا يمكن استخدام حماية بديلة: رقم تسلسلي يزيد مع كل طلب، ولا تُعرض النتائج إلا إذا كان رقم الرد هو آخر رقم أُرسل. هذا لا يوقف الطلب على الشبكة، لكنه يمنع الرد القديم من الكتابة فوق الجديد. ويمكن الجمع بين الطريقتين: إلغاء حيث أمكن، وتحقق من الرقم في كل الأحوال.
وتحقق أيضاً أن النتائج المعروضة تخص النص الحالي في الخانة. إذا مسح الزبون الكلمة كلها، فلا تعرض نتائج طلب وصل متأخراً.
مهلة زمنية للشبكات البطيئة
إذا بقي الطلب معلقاً طويلاً، يبقى الزبون أمام مؤشر تحميل لا ينتهي. تذكر MDN أن AbortSignal.timeout() تعيد إشارة تُلغي العملية تلقائياً بعد عدد محدد من الميلي ثانية. وتذكر أيضاً AbortSignal.any() لدمج أكثر من إشارة، مثل إشارة الإلغاء اليدوي وإشارة المهلة معاً. استخدم هذا لتعرض بعد المهلة رسالة واضحة مثل «البحث بطيء الآن، جرّب مرة أخرى»، بدل الانتظار الصامت. تحقق من دعم any() في المتصفحات التي يستخدمها زبائنك قبل الاعتماد عليها.
جانب الخادم
إلغاء الطلب في المتصفح لا يعني دائماً أن الخادم توقف عن العمل عليه، فقد يكمل الاستعلام ويرمي النتيجة. لذلك:
- اجعل استعلام البحث سريعاً، وحدد عدد النتائج المعادة للبحث الفوري، فعشر نتائج تكفي للقائمة المنسدلة.
- أعد حقولاً قليلة: الاسم والصورة المصغرة والرابط والسعر، لا وصف المنتج كاملاً.
- إن كانت المنصة تدعم ذلك، أوقف المعالجة عندما ينقطع اتصال العميل.
اختبر على شبكة بطيئة
افتح أدوات المطور في المتصفح، واختر محاكاة شبكة بطيئة، ثم اكتب كلمة طويلة بسرعة. راقب لوحة الشبكة: يجب أن ترى الطلبات القديمة ملغاة، وأن تبقى النتائج المعروضة مطابقة للكلمة في الخانة. ثم جرّب على جوال حقيقي بشبكة البيانات. اكتب كلمات عربية وأخرى إنجليزية، لأن زبائن متجرك قد يبحثون عن «شامبو» أو «shampoo».
ماذا يرى الزبون أثناء الانتظار؟
الإصلاح التقني لا يكفي إن بقيت الواجهة مربكة. اعرض مؤشراً صغيراً داخل الخانة أثناء البحث، وأخفه عند وصول الرد أو عند الإلغاء. وإذا لم توجد نتائج، فاكتب ذلك صراحة مع اقتراح بديل، مثل تجربة اسم الصنف بالإنجليزية أو التصفح حسب القسم، بدل قائمة فارغة لا تقول شيئاً.
أخطاء شائعة
- عرض رسالة «حدث خطأ» عند كل إلغاء، لأن الكود لا يميز AbortError.
- إنشاء AbortController واحد واستخدامه لكل الطلبات، فبعد أول إلغاء تفشل كل الطلبات التالية لأن الإشارة ملغاة أصلاً.
- إلغاء الطلب دون إخفاء مؤشر التحميل، فيبقى يدور.
- الاعتماد على debounce وحده، وهو لا يمنع الردود من الوصول بغير ترتيبها.
مثال توضيحي: صيدلية أونلاين ونتائج لا تطابق الكلمة
لنفترض صيدلية في عمّان لها متجر إلكتروني، ووصلتها ملاحظات أن البحث «يجيب أشياء غلط» على الجوال. عند الاختبار بشبكة بطيئة ظهرت المشكلة: نتائج الحروف الأولى تكتب فوق النتائج الأخيرة. أضاف المطوّر إلغاء الطلب السابق، وانتظاراً قصيراً قبل الإرسال، وتجاهلاً لخطأ الإلغاء، ومهلة برسالة واضحة. ثم أعاد الاختبار بالكلمات نفسها.
هذا مثال توضيحي لطريقة المعالجة، دون أرقام أو نتائج مقاسة.
أسئلة شائعة
ليش البحث بموقعي بيطلع نتائج كلمة ثانية؟
غالباً لأن رد طلب قديم وصل بعد الرد الجديد وكتب فوقه. ألغِ الطلب السابق قبل إرسال الجديد.
شو هو AbortController؟
كائن في المتصفح يسمح بإلغاء طلب fetch قبل أن يكتمل، وهو متاح على نطاق واسع بحسب MDN.
هل الإلغاء بيوقف الشغل على السيرفر؟
ليس دائماً. قد يكمل الخادم الاستعلام، لذلك اجعل استعلام البحث الفوري خفيفاً ومحدود النتائج.
كم حرف لازم يكتب الزبون قبل ما يبدأ البحث؟
لا يوجد رقم ثابت، لكن البدء بعد حرفين أو ثلاثة يقلل الطلبات والنتائج العامة. جرّب مع كلمات زبائنك.
إذا كان البحث في متجرك يعرض نتائج لا تطابق ما يكتبه الزبون، احكِ لنا عنه ونفحصه معك على شبكة بطيئة.