التابع deferred.fail() في jQuery
deferred.fail( failCallbacks [, failCallbacks ] )
القيمة المعادة
تُعيد كائنًا من النوع Deferred.
الوصف
يُضيف هذا التابع مُداوِلات تُستدعى عند رفض الكائن المؤجل Deferred.
deferred.fail( failCallbacks [, failCallbacks ] )
أُضيف مع الإصدار: 1.5
failCallbacks
هو دالة، أو مصفوفة دوال، تُستدعى عند رفض الكائن المؤجل Deferred وهو من النوع دالة Function().
failCallbacks
هو دالة إضافية اختيارية، أو مصفوفة دوال، تُستدعى عند رفض الكائن المؤجل Deferred وهو من النوع دالة Function{().
يقبل التابع deferred.fail() وسيطًا واحدًا أو أكثر، ويمكن أن تكون كلها إما دالة مفردة أو مصفوفة من الدوال. عند رفض الكائن المؤجل Differed، تستدعى failCallbacks. وتُنفَّذ ردود النداء بالترتيب الذي أُضيفت به. بما أن deferred.fail() يعيد الكائن المؤجل، يمكن تقييد التوابع الأخرى للكائن المؤجل به، بما في ذلك توابع deferred.fail() إضافية. تُنفَّذ failCallbacks باستخدام الوسائط المقدمة إلى استدعاءات التوابع deferred.reject() أو deferred.rejectWith() بالترتيب الذي أُضيفت به. لمزيد من المعلومات ، راجع وثائق Deferred object .
مثال
بما أن التابع jQuery.get يُعيد الكائن jqXHR، وهو مشتق من الكائن المؤجل Deferred، يمكنك إرفاق ردود نداء بالنجاح والفشل باستخدام التوابع deferred.done() و deferred.fail() على التوالي.
$.get( "test.php" )
.done(function() {
alert( "$.get succeeded" );
})
.fail(function() {
alert( "$.get failed!" );
});