الفرق بين المراجعتين لصفحة: «jQuery/deferred/catch»

من موسوعة حسوب
لا ملخص تعديل
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:التابع <code>deferred.catch()‎</code>‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery}}</noinclude>
<noinclude>{{DISPLAYTITLE:التابع <code>deferred.catch()‎</code>‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery}}</noinclude>


== deferred.catch( failFilter )‎ ==
== <code>deferred.catch( failFilter )‎</code> ==


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


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


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


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


<code>deferred.catch( fn )‎</code> هو اسم مستعار للتابع <code>deferred.then( null, fn )‎</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>، وهو مشتق من كائن مؤجل، يمكننا أن<!-- يوجد جزء غير مفهوم في صفحة المصدر --> مُداوِلات رفض باستخدام التابع ‎ <code>.catch</code>. <syntaxhighlight lang="jquery">
بما أن التابع <code>[[jQuery/jQuery.get|jQuery.get]]</code> يُعيد كائن <code>jqXHR</code>، وهو مشتق من الكائن Deferred، فيمكننا أن ننشئ دوال لمعالجة حالة رفض الكائن باستخدام التابع ‎ <code>.catch</code>. <syntaxhighlight lang="jquery">
$.get( "test.php" )
$.get( "test.php" )
   .then( function() {
   .then( function() {
سطر 29: سطر 29:


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

مراجعة 10:07، 6 مايو 2018


deferred.catch( failFilter )‎

‎‎القيمة المعادة

يُعيد التابع deferred.catch( failFilter )‎ كائنًا من النوع Promise.

الوصف

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

deferred.catch( failFilter )‎

أُضيف مع الإصدار: 3.0.

failFilter

هو دالة تُستدعى عند رفض الكائن المؤجل Deferred، وهو دالة Function()‎.

deferred.catch( fn )‎ هو اسم مستعار للتابع deferred.then( null, fn )‎ . اقرأ صفحته لمزيد من المعلومات.

مثال

بما أن التابع jQuery.get يُعيد كائن jqXHR، وهو مشتق من الكائن Deferred، فيمكننا أن ننشئ دوال لمعالجة حالة رفض الكائن باستخدام التابع ‎ .catch.

$.get( "test.php" )
  .then( function() {
    alert( "$.get succeeded" );
  } )
  .catch( function() {
    alert( "$.get failed!" );
  } );

مصادر