الفرق بين المراجعتين ل"jQuery/deferred/catch"
اذهب إلى التنقل
اذهب إلى البحث
Khaled-yassin (نقاش | مساهمات) ط (←مصادر) |
|||
سطر 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> كائنًا من النوع | + | يُعيد التابع <code>deferred.catch( failFilter )</code> كائنًا من النوع [[JavaScript/Promise|Promise]]. |
=== الوصف === | === الوصف === | ||
− | يُضيف هذا التابع | + | يُضيف هذا التابع دوال معالجة أحداث تُستدعى عند رفض الكائن المؤجل 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، وهو دالة <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>[[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!" );
} );