عرض مصدر jQuery/deferred/fail

<noinclude>{{DISPLAYTITLE:التابع <code>deferred.fail()‎‎</code>‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery}}</noinclude>
== <code>deferred.fail( failCallbacks [, failCallbacks ] )‎</code> ==

=== القيمة المعادة ===
يُعيد كائنًا من النوع [[JavaScript/Deferred|Deferred]].

=== الوصف ===
يُضيف هذا التابع معالجات تُستدعى عند رفض الكائن المؤجل <code>Deferred</code>.

=== <code>deferred.fail( failCallbacks [, failCallbacks ] )‎</code> ===
أُضيف مع الإصدار: [http://api.jquery.com/category/version/1.5/ 1.5].

<code>failCallbacks</code>

هو دالة، أو مصفوفة دوال، تُستدعى عند رفض الكائن المؤجل Deferred، وهو دالة <code>[[JavaScript/Function|Function()]]</code>‎.

<code>failCallbacks</code>

هو دالة إضافية اختيارية، أو مصفوفة دوال، تُستدعى عند رفض الكائن المؤجل Deferred، وهو على الشكل <code>[[JavaScript/Function|Function()]]</code>‎.

يقبل التابع <code>deferred.fail()</code>‎ وسيطًا واحدًا أو أكثر، ويمكن أن تكون كلها إما دالة مفردة أو مصفوفة من الدوال. عند رفض الكائن المؤجل <code>Differed</code>، تستدعى <code>failCallbacks</code>. وتُنفَّذ دوال رد النداء بالترتيب الذي أُضيفت به.

ولما كانت <code>deferred.fail()</code>‎ تعيد الكائن المؤجل، يمكن تنفيذ التوابع الأخرى للكائن المؤجل كسلسلة (chain)، بما في ذلك توابع <code>deferred.fail()‎</code> إضافية. وتُنفَّذ <code>failCallbacks</code> باستخدام الوسائط التي مررناها للتوابع <code>[[jQuery/deferred/reject|deferred.reject()‎]]</code> أو <code>[[jQuery/deferred/rejectWith|deferred.rejectWith()‎]]</code> بالترتيب الذي أُضيفت به. لمزيد من المعلومات ، راجع توثيق الكائن <code>[[jQuery/deferred|Deferred]]</code> .

=== أمثلة ===
لمّا كان التابع <code>[[jQuery/jQuery.get|jQuery.get]]</code> يُعيد الكائن <code>jqXHR</code>، وهو مشتق من الكائن <code>Deferred</code>، فيمكنك إرفاق ردود نداء بالنجاح والفشل باستخدام التوابع <code>[[jQuery/deferred/done|deferred.done()‎]]</code> و <code>deferred.fail()</code>‎ على التوالي.<syntaxhighlight lang="jquery">
$.get( "test.php" )
  .done(function() {
    alert( "$.get succeeded" );
  })
  .fail(function() {
    alert( "$.get failed!" );
  });
</syntaxhighlight>

== مصادر ==
* [http://api.jquery.com/deferred.fail/ صفحة التابع ‎.deferred.fail()‎‎‎ في توثيق jQuery الرسمي].
[[تصنيف:jQuery]]
[[تصنيف:jQuery Method]]
[[تصنيف:jQuery Data]]