شارك المقالة
Debounce في Flutter: تقليل طلبات البحث وإلغاء المؤقت

Debounce في Flutter: تقليل طلبات البحث وإلغاء المؤقت

Debounce في Flutter: إلغاء مؤقت Debounce لا يلغي طلب شبكة بدأ بالفعل.

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

الفرق بين Debounce وThrottle

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

إلغاء العمل عند مغادرة الشاشة

أنشئ Debouncer في State واستدعِه من onChanged، ثم استدعِ dispose داخل dispose الخاص بالشاشة قبل super.dispose. إلغاء Timer يمنع callback الذي لم يبدأ، لكنه لا يلغي طلب HTTP بدأ بالفعل. إذا كانت النتائج قد تصل بترتيب مخالف لترتيب الطلبات، استخدم رقمًا متزايدًا للطلب أو آلية إلغاء تدعمها طبقة الشبكة.

معالجة البحث الفارغ والنتائج القديمة

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

ماذا يتحقق منه الاختبار؟

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

مثال تطبيقي

المقطع التالي مستقل في ملف Dart. اختُبر منطق Dart والواجهات المشار إليها، وتبقى إعدادات المنصة والتجربة على جهاز فعلي مطلوبة قبل النشر.

import 'dart:async';

class Debouncer {
  Debouncer(this.delay);
  final Duration delay;
  Timer? _timer;
  bool _disposed = false;

  void call(void Function() action) {
    if (_disposed) throw StateError('Debouncer is disposed');
    _timer?.cancel();
    _timer = Timer(delay, () {
      _timer = null;
      action();
    });
  }

  void cancel() {
    _timer?.cancel();
    _timer = null;
  }

  void dispose() {
    cancel();
    _disposed = true;
  }
}

تطبيق Debounce في Flutter في مشروعك

إلغاء مؤقت Debounce لا يلغي طلب شبكة بدأ بالفعل؛ استخدم رقم طلب أو رمز إلغاء حتى لا تستبدل نتيجة قديمة نتيجة البحث الأحدث.

مراجع الموضوع: pub.dev — easy_debounce

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع