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