الفرق بين المراجعتين لصفحة: «jQuery/deferred/fail»
Khaled-yassin (نقاش | مساهمات) |
لا ملخص تعديل |
||
| سطر 3: | سطر 3: | ||
=== القيمة المعادة === | === القيمة المعادة === | ||
يُعيد كائنًا من النوع [[JavaScript/Deferred|Deferred]]. | |||
=== الوصف === | === الوصف === | ||
يُضيف هذا التابع معالجات تُستدعى عند رفض الكائن المؤجل Deferred. | يُضيف هذا التابع معالجات تُستدعى عند رفض الكائن المؤجل <code>Deferred</code>. | ||
=== <code>deferred.fail( failCallbacks [, failCallbacks ] )</code> === | === <code>deferred.fail( failCallbacks [, failCallbacks ] )</code> === | ||
| سطر 13: | سطر 13: | ||
<code>failCallbacks</code> | <code>failCallbacks</code> | ||
هو دالة، أو مصفوفة دوال، تُستدعى عند رفض الكائن المؤجل | هو دالة، أو مصفوفة دوال، تُستدعى عند رفض الكائن المؤجل Deferred، وهو دالة <code>[[JavaScript/Function|Function()]]</code>. | ||
<code>failCallbacks</code> | <code>failCallbacks</code> | ||
هو دالة إضافية اختيارية، أو مصفوفة دوال، تُستدعى عند رفض الكائن المؤجل | هو دالة إضافية اختيارية، أو مصفوفة دوال، تُستدعى عند رفض الكائن المؤجل Deferred، وهو على الشكل <code>[[JavaScript/Function|Function()]]</code>. | ||
يقبل التابع <code>deferred.fail()</code> وسيطًا واحدًا أو أكثر، ويمكن أن تكون كلها إما دالة مفردة أو مصفوفة من الدوال. عند رفض الكائن المؤجل | يقبل التابع <code>deferred.fail()</code> وسيطًا واحدًا أو أكثر، ويمكن أن تكون كلها إما دالة مفردة أو مصفوفة من الدوال. عند رفض الكائن المؤجل <code>Differed</code>، تستدعى <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>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" ) | $.get( "test.php" ) | ||
.done(function() { | .done(function() { | ||
مراجعة 06:01، 7 مايو 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!" );
});