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

<noinclude>{{DISPLAYTITLE:التابع <code>deferred.catch()‎</code>‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery}}</noinclude>
== <code>deferred.catch( failFilter )‎</code> ==

=== ‎‎القيمة المعادة ===
يُعيد التابع <code>deferred.catch( failFilter )‎</code> كائنًا من النوع [[JavaScript/Promise|Promise]].

=== الوصف ===
يُضيف هذا التابع دوال معالجة أحداث تُستدعى عند رفض الكائن المؤجل Deferred.

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

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

<code>deferred.catch( fn )‎</code> هو اسم مستعار للتابع <code>[[jQuery/deferred/then|deferred.then]]( null, fn )‎</code> . اقرأ صفحته لمزيد من المعلومات.

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

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