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