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

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

المراجعة الحالية بتاريخ 11:01، 1 يوليو 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!" );
  });

مصادر

صفحة التابع ‎.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> ==
 === القيمة المعادة ===
-تُعيد كائنًا من النوع [[JavaScript/Deferred|Deferred]].
+يُعيد كائنًا من النوع [[JavaScript/Deferred|Deferred]].
 === الوصف ===
-يرفُض هذا التابع كائنًا مؤجلًا ويستدعي أي failCallbacks مع الوسيط <code>args</code> المُعطى.
+يُضيف هذا التابع معالجات تُستدعى عند رفض الكائن المؤجل <code>Deferred</code>.
-=== <code>deferred.reject( [args ] )‎</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>args</code> ====
+==== <code>failCallbacks</code> ====
-يمكن أن يكون من أي نوع من أنواع JavaScript.
+هو دالة، أو مصفوفة دوال، تُستدعى عند رفض الكائن المؤجل Deferred، وهو دالة <code>[[JavaScript/Function|Function()]]</code>‎.
-وسائط اختيارية تُمرر إلى failCallbacks.
+==== <code>failCallbacks</code> ====
+هو دالة إضافية اختيارية، أو مصفوفة دوال، تُستدعى عند رفض الكائن المؤجل Deferred، وهو على الشكل <code>[[JavaScript/Function|Function()]]</code>‎.
-عادة، يجب أن يستدعي هذا التابع فقط منشئ الكائن المؤجل Deferred؛ يمكنك منع الشيفرات البرمجية الأخرى من تغيير حالة الكائن المؤجل بإعادة كائن تعهُّد Promise مقيد من خلال <code>[[jQuery/deferred.promise|deferred.promise()‎]]</code>.
+يقبل التابع <code>deferred.fail()</code>‎ وسيطًا واحدًا أو أكثر، ويمكن أن تكون كلها إما دالة مفردة أو مصفوفة من الدوال. عند رفض الكائن المؤجل <code>Differed</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()‎]].
+ولما كانت <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> يُعيد الكائن <code>jqXHR</code>، وهو مشتق من الكائن <code>Deferred</code>، فيمكنك إرفاق ردود نداء بالنجاح والفشل باستخدام التوابع <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]]
+[[تصنيف:jQuery Deferred Object]]