الفرق بين المراجعتين لصفحة: «jQuery/deferred/pipe»
Khaled-yassin (نقاش | مساهمات) ط ←الوصف |
Khaled-yassin (نقاش | مساهمات) لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:التابع <code>deferred.pipe()</code> في jQuery}}</noinclude> | <noinclude>{{DISPLAYTITLE:التابع <code>deferred.pipe()</code> في jQuery}}</noinclude> | ||
== <code>deferred.pipe( [doneFilter ] [, failFilter ] )</code> == | == <code>deferred.pipe( [doneFilter ] [, failFilter ] )</code> == | ||
أوقِفت مع الإصدار: [http://api.jquery.com/category/version/1.8/ 1.8] | أوقِفت مع الإصدار: [http://api.jquery.com/category/version/1.8/ 1.8]. | ||
=== القيمة المعادة === | === القيمة المعادة === | ||
يُعيد كائنًا من النوع [[JavaScript/Promise| | يُعيد كائنًا من النوع [[JavaScript/Promise|Promise]]. | ||
=== الوصف === | === الوصف === | ||
| سطر 10: | سطر 10: | ||
=== <code>deferred.pipe ([doneFilter] [، failFilter])</code> === | === <code>deferred.pipe ([doneFilter] [، failFilter])</code> === | ||
أُضيف مع الإصدار: [http://api.jquery.com/category/version/1.6/ 1.6] | أُضيف مع الإصدار: [http://api.jquery.com/category/version/1.6/ 1.6]. | ||
==== <code>doneFilter</code> ==== | ==== <code>doneFilter</code> ==== | ||
هو دالة اختيارية تُستدعى عند حل الكائن المؤجل Deferred وهو | هو دالة اختيارية تُستدعى عند حل الكائن المؤجل Deferred وهو على الشكل [[JavaScript/Function|Function()]]. | ||
==== <code>failFilter</code> ==== | ==== <code>failFilter</code> ==== | ||
هو دالة اختيارية تُستدعى عند رفض الكائن المؤجل Deferred وهو | هو دالة اختيارية تُستدعى عند رفض الكائن المؤجل Deferred وهو على الشكل [[JavaScript/Function|Function()]]. | ||
أُضيف مع الإصدار: [http://api.jquery.com/category/version/1.7/ 1.7] | أُضيف مع الإصدار: [http://api.jquery.com/category/version/1.7/ 1.7]. | ||
=== <code>deferred.pipe ([doneFilter] [، failFilter] [، progressFilter])</code> === | === <code>deferred.pipe ([doneFilter] [، failFilter] [، progressFilter])</code> === | ||
==== <code>doneFilter</code> ==== | ==== <code>doneFilter</code> ==== | ||
هو دالة اختيارية تُستدعى عند حل الكائن المؤجل Deferred وهو | هو دالة اختيارية تُستدعى عند حل الكائن المؤجل Deferred وهو على الشكل [[JavaScript/Function|Function()]]. | ||
==== <code>failFilter</code> ==== | ==== <code>failFilter</code> ==== | ||
هو دالة اختيارية تُستدعى عند رفض الكائن المؤجل Deferred وهو | هو دالة اختيارية تُستدعى عند رفض الكائن المؤجل Deferred وهو على الشكل [[JavaScript/Function|Function()]]. | ||
==== <code>progressFilter</code> ==== | ==== <code>progressFilter</code> ==== | ||
هو دالة اختيارية تُستدعى عند إرسال إشعارات التقدُّم للكائن المؤجل Deferred وهو | هو دالة اختيارية تُستدعى عند إرسال إشعارات التقدُّم للكائن المؤجل Deferred وهو على الشكل [[JavaScript/Function|Function()]]. | ||
=== إشعار الإيقاف === | === إشعار الإيقاف === | ||
اعتبارًا من إصدار jQuery 1.8، أُوقِف التابع <code>deferred.pipe()</code>. | اعتبارًا من إصدار jQuery 1.8، أُوقِف التابع <code>deferred.pipe()</code>. ويجب استخدام التابع <code>[[jQuery/deferred/then|deferred.then()]]</code>، الذي يحل محله، بدلاً من ذلك. | ||
يُعيد التابع deferred.pipe() تعهُّدًا جديدًا يعمل على ترشيح حالات وقيم الكائن المؤجل من خلال إحدى الدالات. تُرشِّح الدالتين <code>doneFilter</code> و <code>failFilter</code> حالات حل ورفض الكائن المؤجل الأصلية وقيمه. واعتبارًا من إصدار jQuery 1.7، يقبل هذا التابع أيضًا الدالة <code>progressFilter</code> لترشيح أية نداءات للمؤجل الأصلي للتوابع <code>notify</code> أو <code>notifyWith</code>. يمكن لدوال الترشيح هذه أن تعيد قيمة جديدة لتمرر إلى ردود نداءات التعهدات المُساقة <code>done()</code> أو <code>fail()</code>، أو يمكنها إعادة كائن آخر يمكن مراقبته (مؤجل، تعهُّد، وما إلى ذلك) والذي سيمرر حالة حل أو رفض هذا الكائن وقيمه إلى ردود نداءات التعهدات المُساقة. إذا كانت دالة الترشيح المستخدمة هي <code>null</code> أو غير محددة، فسيحل التعهُّد المُساق أو يُرفض بنفس قيم الأصل. | يُعيد التابع <code>deferred.pipe()</code> تعهُّدًا جديدًا يعمل على ترشيح حالات وقيم الكائن المؤجل من خلال إحدى الدالات. تُرشِّح الدالتين <code>doneFilter</code> و <code>failFilter</code> حالات حل ورفض الكائن المؤجل الأصلية وقيمه. واعتبارًا من إصدار jQuery 1.7، يقبل هذا التابع أيضًا الدالة <code>progressFilter</code> لترشيح أية نداءات للمؤجل الأصلي للتوابع <code>notify</code> أو <code>notifyWith</code>. يمكن لدوال الترشيح هذه أن تعيد قيمة جديدة لتمرر إلى ردود نداءات التعهدات المُساقة <code>done()</code> أو <code>fail()</code>، أو يمكنها إعادة كائن آخر يمكن مراقبته (مؤجل، تعهُّد، وما إلى ذلك) والذي سيمرر حالة حل أو رفض هذا الكائن وقيمه إلى ردود نداءات التعهدات المُساقة. إذا كانت دالة الترشيح المستخدمة هي <code>null</code> أو غير محددة، فسيحل التعهُّد المُساق أو يُرفض بنفس قيم الأصل. | ||
=== أمثلة === | === أمثلة === | ||
مراجعة 15:52، 6 مايو 2018
deferred.pipe( [doneFilter ] [, failFilter ] )
أوقِفت مع الإصدار: 1.8.
القيمة المعادة
يُعيد كائنًا من النوع Promise.
الوصف
تابع أداة يُستخدم لترشيح و/أو تقييد الكائنات المؤجلة Deferreds.
deferred.pipe ([doneFilter] [، failFilter])
أُضيف مع الإصدار: 1.6.
doneFilter
هو دالة اختيارية تُستدعى عند حل الكائن المؤجل Deferred وهو على الشكل Function().
failFilter
هو دالة اختيارية تُستدعى عند رفض الكائن المؤجل Deferred وهو على الشكل Function().
أُضيف مع الإصدار: 1.7.
deferred.pipe ([doneFilter] [، failFilter] [، progressFilter])
doneFilter
هو دالة اختيارية تُستدعى عند حل الكائن المؤجل Deferred وهو على الشكل Function().
failFilter
هو دالة اختيارية تُستدعى عند رفض الكائن المؤجل Deferred وهو على الشكل Function().
progressFilter
هو دالة اختيارية تُستدعى عند إرسال إشعارات التقدُّم للكائن المؤجل Deferred وهو على الشكل Function().
إشعار الإيقاف
اعتبارًا من إصدار jQuery 1.8، أُوقِف التابع deferred.pipe(). ويجب استخدام التابع deferred.then()، الذي يحل محله، بدلاً من ذلك.
يُعيد التابع deferred.pipe() تعهُّدًا جديدًا يعمل على ترشيح حالات وقيم الكائن المؤجل من خلال إحدى الدالات. تُرشِّح الدالتين doneFilter و failFilter حالات حل ورفض الكائن المؤجل الأصلية وقيمه. واعتبارًا من إصدار jQuery 1.7، يقبل هذا التابع أيضًا الدالة progressFilter لترشيح أية نداءات للمؤجل الأصلي للتوابع notify أو notifyWith. يمكن لدوال الترشيح هذه أن تعيد قيمة جديدة لتمرر إلى ردود نداءات التعهدات المُساقة done() أو fail()، أو يمكنها إعادة كائن آخر يمكن مراقبته (مؤجل، تعهُّد، وما إلى ذلك) والذي سيمرر حالة حل أو رفض هذا الكائن وقيمه إلى ردود نداءات التعهدات المُساقة. إذا كانت دالة الترشيح المستخدمة هي null أو غير محددة، فسيحل التعهُّد المُساق أو يُرفض بنفس قيم الأصل.
أمثلة
قيمة حل الترشيح:
var defer = $.Deferred(),
filtered = defer.pipe(function( value ) {
return value * 2;
});
defer.resolve( 5 );
filtered.done(function( value ) {
alert( "Value is ( 2*5 = ) 10: " + value );
});
قيمة رفض الترشيح:
var defer = $.Deferred(),
filtered = defer.pipe( null, function( value ) {
return value * 3;
});
defer.reject( 6 );
filtered.fail(function( value ) {
alert( "Value is ( 3*6 = ) 18: " + value );
});
مهام مُقيَّدة:
var request = $.ajax( url, { dataType: "json" } ),
chained = request.pipe(function( data ) {
return $.ajax( url2, { data: { user: data.userId } } );
});
chained.done(function( data ) {
// data retrieved from url2 as provided by the first request
});