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

التعديل اللاحق ←

مرئينص الويكي

مراجعة 23:57، 4 مايو 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()‎ يعيد الكائن المؤجل، يمكن تقييد التوابع الأخرى للكائن المؤجل به، بما في ذلك توابع deferred.fail()‎ إضافية. تُنفَّذ failCallbacks باستخدام الوسائط المقدمة إلى استدعاءات التوابع deferred.reject()‎ أو deferred.rejectWith()‎ بالترتيب الذي أُضيفت به. لمزيد من المعلومات ، راجع وثائق Deferred object .

مثال

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

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

مصادر

صفحة التابع ‎.deferred.fail()‎‎‎ في توثيق jQuery الرسمي.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE:التابع <code>deferred.reject()‎‎</code>‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery}}</noinclude>
+<noinclude>{{DISPLAYTITLE:التابع <code>deferred.fail()‎‎</code>‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery}}</noinclude>
-== <code>deferred.reject( [args ] )‎</code> ==
+== <code>deferred.fail( failCallbacks [, failCallbacks ] )‎</code> ==
 === القيمة المعادة ===
@@ سطر 6: / سطر 6: @@
 === الوصف ===
-يرفُض هذا التابع كائنًا مؤجلًا ويستدعي أي failCallbacks مع الوسيط <code>args</code> المُعطى.
+يُضيف هذا التابع مُداوِلات تُستدعى عند رفض الكائن المؤجل Deferred.
-=== <code>deferred.reject( [args ] )‎</code> ===
+=== <code>deferred.fail( failCallbacks [, failCallbacks ] )‎</code> ===
 أُضيف مع الإصدار: [http://api.jquery.com/category/version/1.5/ 1.5]
-==== <code>args</code> ====
+<code>failCallbacks</code>
-يمكن أن يكون من أي نوع من أنواع JavaScript.
-وسائط اختيارية تُمرر إلى failCallbacks.
+هو دالة، أو مصفوفة دوال، تُستدعى عند رفض الكائن المؤجل Deferred وهو من النوع [[JavaScript/Function|دالة]] Function()‎.
-عادة، يجب أن يستدعي هذا التابع فقط منشئ الكائن المؤجل Deferred؛ يمكنك منع الشيفرات البرمجية الأخرى من تغيير حالة الكائن المؤجل بإعادة كائن تعهُّد Promise مقيد من خلال <code>[[jQuery/deferred.promise|deferred.promise()‎]]</code>.
+<code>failCallbacks</code>
-عندما يتم رفض الكائن المؤجل Deferred، يستدعى أي failCallbacks سبق وأن أُضيف بواسطة التابع <code>[[jQuery/deferred.then|deferred.then()‎]]</code> أو التابع <code>[[jQuery/deferred.fail|deferred.fail()‎]]</code>. تُنفَّذ ردود النداء بالترتيب الذي أُضيفت به. يُمرر الوسيط <code>args</code> لكل رد نداء من استدعاء <code>deferred.reject()‎</code>. ينفَّذ أي failCallbacks أُضيف بعد إدخال الكائن المؤجل Deferred إلى حالة الرفض فورًا عند إضافته، باستخدام الوسائط التي مُرِرت إلى الاستدعاء <code>deferred.reject()‎</code>. لمزيد من المعلومات، راجع وثائق [[jQuery/jQuery.Deferred|jQuery.Deferred()‎]].
+هو دالة إضافية اختيارية، أو مصفوفة دوال، تُستدعى عند رفض الكائن المؤجل 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>[[jQuery/jQuery.get|jQuery.get]]</code> يُعيد الكائن jqXHR، وهو مشتق من الكائن المؤجل Deferred، يمكنك إرفاق ردود نداء بالنجاح والفشل باستخدام التوابع <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.reject/ صفحة التابع ‎.deferred.reject()‎‎‎ في توثيق jQuery الرسمي].
+* [http://api.jquery.com/deferred.fail/ صفحة التابع ‎.deferred.fail()‎‎‎ في توثيق jQuery الرسمي].
 [[تصنيف:jQuery]]
 [[تصنيف:jQuery Method]]
 [[تصنيف:jQuery Data]]