تأخير معالجات الإدخال في React (Debouncing)
يتناول هذا المقال تقنية debouncing، أي تأجيل ما يحدث عمدًا عند تفاعل المستخدم مع حقول الإدخال.
موضوع هذا المقال هو debouncing، أو بعبارة أخرى، تأجيل ما ينتج عن تفاعل المستخدم مع حقول الإدخال عن قصد.
معالجة الأحداث
في React (وفي JavaScript عمومًا)، تُعالَج تغييرات حقول الإدخال عادةً بشكل من أشكال مستمعي الأحداث، مثل دوال onChange. خذ حقل نص عاديًا: كل ضغطة مفتاح تستدعي المعالج المرتبط به وتمرر إليه كائن حدث يحمل أحدث قيمة.
const handler = (event: React.ChangeEvent<HTMLInputElement>) => {
/*..*/
};
/*..*/
<input onChange={handler} />;
يعمل هذا جيدًا للحفاظ على تزامن حالة التطبيق، لكن هل هو ما نريده في كل مرة؟ هل يجب فعلًا أن يؤدي كل تغيير صغير إلى أثر، مهما كان الموقف؟
حالة الاستخدام
افترض أنك تبني مكوّن بحث نصيًا لتطبيقك، حيث يكتب المستخدم عبارة البحث في حقل إدخال بسيط. ولتحسين تجربة الاستخدام تحذف زر «الإرسال» وترسل العبارة إلى API بينما لا يزال المستخدم يكتب. هكذا تعمل الواجهات الحديثة عادةً.
يسير كل شيء على ما يرام حتى تلاحظ أن كل ضغطة مفتاح تجعل المتصفح يرسل طلب XHR (HTTP) إلى الخادم الخلفي. اضرب ذلك في عدد الأشخاص الذين يستخدمون تطبيقك في اللحظة نفسها، وها أنت قد أنشأت دون قصد ما يشبه هجوم DDoS (حجب الخدمة الموزع). في أفضل الأحوال – عندما يُغرَق الخادم بمئات الطلبات في فترة قصيرة نسبيًا – ستضع آليات الحماية IDS/IPS بعض عناوين IP للعملاء في القائمة السوداء. وفي أسوأ الأحوال ينهار الخادم الخلفي بأكمله.
❗️ علاوة على ذلك، فإن إطلاق هذا العدد الكبير من الطلبات غير المتزامنة في فترة قصيرة يرفع بدرجة كبيرة احتمال وصول الردود بترتيب خاطئ.
وبالنسبة للمستخدم، يسبب حالة التسابق هذه تناقضات مزعجة جدًا في الواجهة، مثل أن يُحَل طلب أقدم أخيرًا، فتعرض الواجهة نتائج لنسخة قديمة من عبارة البحث.
تأثيرات بدون debouncing
يوضح الرسم المتحرك أدناه «فيضان» الأحداث القادمة من حقل إدخال بدون debouncing:
تُعالَج كل ضغطة مفتاح على حدة. وتسجل نافذة «المصحح» كل «أثر»، محاكيةً الاستعلامات التي قد تُرسل إلى الخادم الخلفي. من الواضح أن هذا بعيد عن المثالي.
المعالجة الصحيحة للأحداث
هنا أستخدم lodash.debounce (وهي في الأساس دالة مستقلة مأخوذة من مكتبة lodash «الأم») لبناء نسخة مؤجَّلة من معالج الحدث:
import debounce from "lodash.debounce";
const DEBOUNCE_TIME_MS = 300;
/*..*/
const onNameChange = useMemo(
() =>
debounce((event: React.ChangeEvent<HTMLInputElement>) => {
setEffects(/*..*/);
}, DEBOUNCE_TIME_MS),
[]
);
في هذا الكود تأخذ debounce وسيطين: الدالة (المعالج) function ومدة الانتظار wait.
ℹ️ بالمعنى الدقيق، تأخذ
debounceوسيطًا ثالثًا أيضًا هوoptions، يتيح لك تحديد ما إذا كان المعالج سيعمل عند الحافة الأولى و/أو الأخيرة للمهلة. لكنه اختياري ويمكن حذفه.
وفوق ذلك، يُغلَّف كل شيء بالخطاف useMemo في React حتى لا تُعاد إنشاء الدالة دون داعٍ عند كل عملية عرض.
يوضح الرسم المتحرك أدناه سلوك معالج الحدث المؤجَّل.
الفرق سهل الملاحظة: فبينما ظل المستخدم يكتب (مع «فجوة» بين الضغطات أقصر من DEBOUNCE_TIME_MS)، تأجل الأثر.
لاحظ كيف توقف المستخدم مرتين للحظة أثناء الكتابة، قرب نهاية الجملة (ومرة ثالثة عندما انتهى)؟ تلك هي اللحظات التي نُفِّذت فيها الآثار المؤجَّلة. سجّل المصحح 3 آثار فقط، وهو تحسن هائل مقارنةً بـ حوالي 13 ضعفًا من الأحداث في النسخة بدون debouncing!
ℹ️ تذكّر – يعمل معالج الحدث المؤجَّل تقريبًا على النحو التالي:
- يلتقط الأحداث التي ينتجها المستخدم و«يجمعها»؛
- ينتظر حتى تمر فترة «هدوء» (بلا أحداث)، تبلغ عادةً نحو 300-500 مللي ثانية؛
- ينفذ الأثر باستخدام «أحدث» بيانات.
التنظيف
من الجيد أيضًا توفير منطق تنظيف في حال إزالة المكوّن (على سبيل المثال عندما يغادر المستخدم المسار). لهذا السبب يجب أن تضيف useEffect تُرجِع دالة تستدعي الطريقة .cancel() الخاصة بمعالج الحدث المؤجَّل.
useEffect(() => {
return () => {
onNameChange.cancel();
};
}, [onNameChange]);
💡 السبب: افترض أن
DEBOUNCE_TIME_MSطويلة بما يكفي (مثلًا 1000-2000 مللي ثانية) لحدوث ما يلي:
- يبدأ المستخدم الكتابة؛
- ثم يغادر المسار الحالي فورًا، فيُزال مكوّن البحث قبل أن يُنفَّذ الأثر المؤجَّل
في هذه الحالة الافتراضية قد تنتهي إلى تسرب في الذاكرة، وبدقة أكبر محاولة تحديث حالة مكوّن أُزيل بالفعل. لهذا من الممارسات الجيدة دائمًا مسح أي مهام مجدولة نعلم أنها لن تُعالَج معالجة صحيحة.
كل دالة تُرجَع من استدعاء
debounce(..)تأتي مع بعض الخصائص الإضافية، ولهذا يمكن استدعاء.cancel()عليها.
ملاحظات ختامية
لتقديم تجربة مستخدم ممتازة، يجب أن تراعي الواجهات الحديثة الأداء. وتحسين طريقة معالجة الأحداث والآثار ليس سوى واحد من أمور كثيرة يجب على المهندسين أخذها في الحسبان.
هذا لا يعني أن عليك «إصلاح» كل حقل إدخال في كل تطبيقاتك، فمن المقبول تمامًا مثلًا أن يحدّث حقل نص عادي حالة النموذج في الذاكرة عند كل ضغطة مفتاح. فكّر دائمًا فيما ستسببه معالجة الأحداث بترددات مختلفة، واختر الاستراتيجية الملائمة للموقف.
ℹ️ إذا كنت فضوليًا، ستجد هنا مثالًا عمليًا لمعالج حدث مؤجَّل مع الشيفرة الكاملة.