التابع deferred.reject() في jQuery
deferred.reject( [args ] )
القيمة المعادة
تُعيد كائنًا من النوع Deferred.
الوصف
يرفُض هذا التابع كائنًا مؤجلًا ويستدعي أي failCallbacks مع الوسيط args المُعطى.
deferred.reject( [args ] )
أُضيف مع الإصدار: 1.5
args
يمكن أن يكون من أي نوع من أنواع JavaScript.
وسائط اختيارية تُمرر إلى failCallbacks.
عادة، يجب أن يستدعي هذا التابع فقط منشئ الكائن المؤجل Deferred؛ يمكنك منع الشيفرات البرمجية الأخرى من تغيير حالة الكائن المؤجل بإعادة كائن تعهُّد Promise مقيد من خلال deferred.promise().
عندما يتم رفض الكائن المؤجل Deferred، يستدعى أي failCallbacks سبق وأن أُضيف بواسطة التابع deferred.then() أو التابع deferred.fail(). تُنفَّذ ردود النداء بالترتيب الذي أُضيفت به. يُمرر الوسيط args لكل رد نداء من استدعاء deferred.reject(). ينفَّذ أي failCallbacks أُضيف بعد إدخال الكائن المؤجل Deferred إلى حالة الرفض فورًا عند إضافته، باستخدام الوسائط التي مُرِرت إلى الاستدعاء deferred.reject(). لمزيد من المعلومات، راجع وثائق jQuery.Deferred().