مؤجل. ثم (doneFilter [، failFilter] [، progressFilter]) إرجاع: Promise
الوصف: إضافة معالجات يتم استدعاؤها عند حل الكائن المؤجل أو رفضه أو ما زال قيد التقدم.
الإصدار المضاف: 1.8 مؤجل. ثم (doneFilter [، failFilter] [، progressFilter])
الإصدار المضاف: 1.5 ، تمت إزالته: 1.8 مؤجلًا.ثم (doneCallbacks، failCallbacks)
الإصدار المضاف: 1.7 ، تمت إزالته: 1.8 مؤجل. ثم (doneCallbacks ، failCallbacks [، progressCallbacks])
قبل jQuery 1.8 ، يمكن أن تكون الوسيطات دالة أو مجموعة من الوظائف.
بالنسبة لجميع التواقيع ، يمكن أن تكون الوسيطات null إذا لم تكن هناك رغبة في معاودة الاتصال من هذا النوع. بدلاً من ذلك ، استخدم .done() أو .fail() أو .progress() لتعيين نوع واحد فقط من الاستدعاء بدون تصفية الحالة أو القيم.
اعتبارًا من jQuery 1.8 ، ترجع طريقة deferred.then() وعدًا جديدًا يمكنه تصفية حالة وقيم المؤجل من خلال وظيفة ، ليحل محل طريقة deferred.pipe() إيقافها الآن. doneFilter failFilter الأصلية التي تم حلها / رفضها. تقوم وظيفة التصفية progressFilter بتصفية أية مكالمات إلى notify المؤجل الأصلي أو notifyWith الطرق. يمكن لوظائف التصفية هذه إرجاع قيمة جديدة ليتم تمريرها إلى .done() أو .fail() ، أو يمكنها إرجاع كائن آخر يمكن ملاحظته (مؤجل ، وعد ، وما إلى ذلك) والذي سينتج حالة وقيم الحل / الرفض إلى الاستدعاءات الوعد. إذا كانت دالة التصفية المستخدمة null أو غير محددة ، فسيتم حل الوعد أو رفضه بنفس قيم الأصل.
يتم تنفيذ عمليات الرد بالترتيب الذي تمت إضافته به. منذ deferred.then بإرجاع Promise ، يمكن تقييد طرق أخرى من الكائن Promise إلى هذا ، بما في ذلك أساليب. .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 demo</title>
<script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
<button>Filter Resolve</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 );
});مهام السلسلة:
var request = $.ajax( url, { dataType: "json" } ),
chained = request.then(function( data ) {
return $.ajax( url2, { data: { user: data.userId } } );
});
chained.done(function( data ) {
// data retrieved from url2 as provided by the first request
});