الفرق بين المراجعتين ل"jQuery/deferred/fail"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط
سطر 9: سطر 9:
  
 
=== <code>deferred.fail( failCallbacks [, failCallbacks ] )‎</code> ===
 
=== <code>deferred.fail( failCallbacks [, failCallbacks ] )‎</code> ===
أُضيف مع الإصدار: [http://api.jquery.com/category/version/1.5/ 1.5]
+
أُضيف مع الإصدار: [http://api.jquery.com/category/version/1.5/ 1.5].
  
 
<code>failCallbacks</code>
 
<code>failCallbacks</code>
  
هو دالة، أو مصفوفة دوال، تُستدعى عند رفض الكائن المؤجل Deferred وهو من النوع [[JavaScript/Function|دالة]] Function()‎.
+
هو دالة، أو مصفوفة دوال، تُستدعى عند رفض الكائن المؤجل Deferred وهو دالة [[JavaScript/Function|Function()]]‎.
  
 
<code>failCallbacks</code>
 
<code>failCallbacks</code>
  
هو دالة إضافية اختيارية، أو مصفوفة دوال، تُستدعى عند رفض الكائن المؤجل Deferred وهو من النوع [[JavaScript/Function|دالة]] Function{()‎.
+
هو دالة إضافية اختيارية، أو مصفوفة دوال، تُستدعى عند رفض الكائن المؤجل Deferred وهو دالة [[JavaScript/Function|Function()]]‎.
  
يقبل التابع <code>deferred.fail()</code>‎ وسيطًا واحدًا أو أكثر، ويمكن أن تكون كلها إما دالة مفردة أو مصفوفة من الدوال. عند رفض الكائن المؤجل Differed، تستدعى failCallbacks. وتُنفَّذ ردود النداء بالترتيب الذي أُضيفت به. بما أن <code>deferred.fail()</code>‎ يعيد الكائن المؤجل، يمكن تقييد التوابع الأخرى للكائن المؤجل به، بما في ذلك توابع deferred.fail()‎ إضافية. تُنفَّذ failCallbacks باستخدام الوسائط المقدمة إلى استدعاءات التوابع <code>[[jQuery/deferred/reject|deferred.reject()‎]]</code> أو <code>[[jQuery/deferred/rejectWith|deferred.rejectWith()‎]]</code> بالترتيب الذي أُضيفت به. لمزيد من المعلومات ، راجع وثائق [[jQuery/Deferred-object|Deferred object]] .
+
يقبل التابع <code>deferred.fail()</code>‎ وسيطًا واحدًا أو أكثر، ويمكن أن تكون كلها إما دالة مفردة أو مصفوفة من الدوال. عند رفض الكائن المؤجل Differed، تستدعى <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> يُعيد الكائن jqXHR، وهو مشتق من الكائن المؤجل Deferred، يمكنك إرفاق ردود نداء بالنجاح والفشل باستخدام التوابع <code>[[jQuery/deferred/done|deferred.done()‎]]</code> و <code>deferred.fail()</code>‎ على التوالي.<syntaxhighlight lang="jquery">
+
 
 +
=== أمثلة ===
 +
بما أن التابع <code>[[jQuery/jQuery.get|jQuery.get]]</code> يُعيد الكائن <code>jqXHR</code>، وهو مشتق من الكائن المؤجل Deferred، يمكنك إرفاق ردود نداء بالنجاح والفشل باستخدام التوابع <code>[[jQuery/deferred/done|deferred.done()‎]]</code> و <code>deferred.fail()</code>‎ على التوالي.<syntaxhighlight lang="jquery">
 
$.get( "test.php" )
 
$.get( "test.php" )
 
   .done(function() {
 
   .done(function() {

مراجعة 13:57، 6 مايو 2018

deferred.fail( failCallbacks [, failCallbacks ] )‎

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

تُعيد كائنًا من النوع Deferred.

الوصف

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

deferred.fail( failCallbacks [, failCallbacks ] )‎

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

failCallbacks

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

failCallbacks

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

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

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

أمثلة

بما أن التابع jQuery.get يُعيد الكائن jqXHR، وهو مشتق من الكائن المؤجل Deferred، يمكنك إرفاق ردود نداء بالنجاح والفشل باستخدام التوابع deferred.done()‎ و deferred.fail()‎ على التوالي.

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

مصادر