التابع deferred.then() في jQuery
deferred.then( doneFilter [, failFilter ] [, progressFilter ] )
القيمة المعادة
يُعيد كائنًا من النوع Promise.
الوصف
يُضيف هذا التابع معالجات تُستدعَى عند قبول الكائن المؤجل أو رفضه أو ما زال قيد التقدم.
deferred.then( doneFilter [, failFilter ] [, progressFilter ] )
أُضيف مع الإصدار: 1.8.
doneFilter
هو دالة تُستدعى عند قبول الكائن المؤجل وهو على الشكل Function().
failFilter
هو دالة اختيارية تُستدعى عند رفض الكائن المؤجل وهو على الشكل Function().
progressFilter
هو دالة إختيارية تُستدعى عند إرسال إشعارات التقدُّم للكائن المؤجل وهو على الشكل Function().
deferred.then( doneCallbacks, failCallbacks )
أُضيف مع الإصدار: 1.5، وحذف مع الإصدار: 1.8.
doneCallbacks
هو دالة، أو مصفوفة من الدوال، تُستدعى عند قبول الكائن المؤجل وهو على الشكل Function().
failCallbacks
هو دالة، أو مصفوفة من الدوال، تُستدعى عند رفض الكائن المؤجل وهو على الشكل Function().
deferred.then( doneCallbacks, failCallbacks [, progressCallbacks ] )
أُضيف مع الإصدار: 1.7، وحذف مع الإصدار: 1.8.
doneCallbacks
هو دالة، أو مصفوفة من الدوال، تُستدعى عند قبول الكائن المؤجل وهو على الشكل Function().
failCallbacks
هو دالة، أومصفوفة من الدوال، تُستدعى عند رفض الكائن المؤجل وهو على الشكل Function().
progressCallbacks
هو دالة، أومصفوفة من الدوال، تُستدعى عند إشعار تقدُّم الكائن المؤجل وهو على الشكل Function().
قبل jQuery 1.8، كان يمكن أن تكون الوسائط دالة أو مصفوفة من الدوال.
لجميع التوقيعات، يمكن أن تكون الوسائط null إذا لم تكن هناك رغبة في رد نداء من هذا النوع. بدلاً من ذلك، استخدم .done() أو .fail() أو .progress() لتعيين نوع واحد فقط من رد النداء بدون ترشيح الحالة أو القيم.
بدءًا من jQuery 1.8، يُعيد التابع deferred.then() كائن promise جديدًا يمكنه ترشيح حالة وقيم الكائن المؤجل من خلال دالة، ليحل محل التابع deferred.pipe() المهمل الآن. تُرشِّح الدالتين doneFilter و failFilter حالات قبول ورفض الكائن المؤجل الأصلية وقيمه. ترشح دالة progressFilter أية استدعاءات إلى تابعي notify و notifyWith للكائن المؤجل الأصلي. يمكن لدوال الترشيح هذه إعادة قيمة جديدة تمرر إلى تابعي .done() أو .fail() لدوال ردود نداء الكائن promise، أو يمكنها إعادة كائن آخر يمكن ملاحظته (Deferred و Promise ، وما إلى ذلك) والذي سيمرر حالة وقيم القبول أو الرفض إلى دوال ردود نداء الكائن promise. إذا كانت دالة الترشيح المستخدمة null أو غير محددة، فسيقبل promise أو يرفض بنفس قيم الأصل.
تُنفَّذ ردود النداء بالترتيب الذي أُضيفت به. ولما كان التابع deferred.then يعيد Promise، يمكن إعادة الكائن Promise كسلسلة (chain) من خلال التابع، بما في ذلك توابع .then() الإضافية.
أمثلة
لما كان التابع jQuery.get يُعيد كائن jqXHR، وهي مشتقة من كائن مؤجل، يمكننا أن نلحق معالجات باستخدام التابع .then.
$.get( "test.php" ).then(
function() {
alert( "$.get succeeded" );
}, function() {
alert( "$.get failed!" );
}
);
ترشيح قيمة القبول:
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>deferred.then مثال على التابع</title>
<script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
<button>قبول المُرشَّح</button>
<p></p>
<script>
var filterResolve = function() {
var defer = $.Deferred(),
filtered = defer.then(function( value ) {
return value * 2;
});
defer.resolve( 5 );
filtered.done(function( value ) {
$( "p" ).html( "Value is ( 2*5 = ) 10: " + value );
});
};
$( "button" ).on( "click", filterResolve );
</script>
</body>
</html>
ترشيح قيمة الرفض:
var defer = $.Deferred(),
filtered = defer.then( null, function( value ) {
return value * 3;
});
defer.reject( 6 );
filtered.fail(function( value ) {
alert( "Value is ( 3*6 = ) 18: " + value );
});
مهام مُعادة كسلسلة (chain) : البيانات المُستردّة من url2 كما هو منصوص عليه في الطلب الأول.
var request = $.ajax( url, { dataType: "json" } ),
chained = request.then(function( data ) {
return $.ajax( url2, { data: { user: data.userId } } );
});
chained.done(function( data ) {
});