الفرق بين المراجعتين ل"jQuery/deferred/then"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>deferred.state()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎</code>‎‎‎‎‎‎‎‎‎‎‎‎‎‎...')
 
ط (استبدال النص - 'JQuery' ب'jQuery')
 
(8 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة)
سطر 1: سطر 1:
−
<noinclude>{{DISPLAYTITLE:التابع <code>deferred.state()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎</code>‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery}}</noinclude>
+
<noinclude>{{DISPLAYTITLE:التابع <code>deferred.then()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎</code>‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery}}</noinclude>
−
== ‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎deferred.state()‎ ==
+
== <code>‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎deferred.then( doneFilter [, failFilter ] [, progressFilter ] )‎</code> ==
  
 
=== القيمة المعادة ===
 
=== القيمة المعادة ===
−
يُعيد كائنًا من النوع [[JavaScript/String|String]].
+
يُعيد كائنًا من النوع [[JavaScript/Promise|Promise]].
  
 
=== الوصف ===
 
=== الوصف ===
−
يُحدد هذا التابع الحالة الحالية لكائن مؤجل.
+
يُضيف هذا التابع معالجات تُستدعَى عند قبول الكائن المؤجل أو رفضه أو ما زال قيد التقدم.
  
−
=== <code>deferred.state()‎</code> ===
+
=== <code>deferred.then( doneFilter [, failFilter ] [, progressFilter ] )‎</code> ===
−
أُضيف مع الإصدار: [http://api.jquery.com/category/version/1.7/ 1.7].
+
أُضيف مع الإصدار: [http://api.jquery.com/category/version/1.8/ 1.8].
  
−
هذا التابع لا يقبل أي وسائط.
+
==== <code>doneFilter</code> ====
 +
هو دالة تُستدعى عند قبول الكائن المؤجل وهو على الشكل <code>[[JavaScript/Function|Function()‎‎]]</code>.
  
−
يعيد التابع <code>deferred.state()‎</code> سلسلة نصية تمثل الحالة الحالية للكائن المؤجل. يمكن أن يكون الكائن المؤجل في إحدى الحالات الثلاث:
+
==== <code>failFilter</code> ====
−
* "معلق pending" : الكائن المؤجل ليس في حالة مكتملة (لا "مرفوض" ولا "مقبول").
+
هو دالة اختيارية تُستدعى عند رفض الكائن المؤجل وهو على الشكل <code>[[JavaScript/Function|Function()‎‎]]</code>.
−
* "مقبول resolved" : الكائن المؤجل موجود في حالة قبول، مما يعني استدعاء التابع <code>[[jQuery/deferred/resolve|deferred.resolve()‎]]</code> أو التابع <code>[[jQuery/deferred/resolveWith|deferred.resolveWith()‎]]</code> للكائن واستدعاء الدالة <code>doneCallbacks</code> (أو قيد الاستدعاء).
+
 
−
* "مرفوض" : الكائن المؤجل موجود في حالة الرفض، مما يعني استدعاء التابع <code>[[jQuery/deferred/reject|deferred.reject()‎]]</code> أو التابع <code>[[jQuery/deferred/rejectWith|deferred.rejectWith()‎]]</code> للكائن واستدعاء الدالة <code>failCallbacks</code> (أو قيد الاستدعاء).
+
==== <code>progressFilter</code> ====
−
هذه الطريقة مفيدة في المقام الأول لتصحيح الأخطاء، على سبيل المثال، لتحديد ما إذا كان الكائن المؤجل قد قُبل بالفعل على الرغم من أنك داخل شيفرة مُعدَّة لرفضه.
+
هو دالة إختيارية تُستدعى عند إرسال إشعارات التقدُّم للكائن المؤجل وهو على الشكل <code>[[JavaScript/Function|Function()‎‎]]</code>.
 +
 
 +
=== <code>deferred.then( doneCallbacks, failCallbacks )‎</code> ===
 +
أُضيف مع الإصدار: [http://api.jquery.com/category/version/1.5/ 1.5]، وحذف مع الإصدار: [http://api.jquery.com/category/version/1.8/ 1.8].
 +
 
 +
==== <code>doneCallbacks</code> ====
 +
هو دالة، أو مصفوفة من الدوال، تُستدعى عند قبول الكائن المؤجل وهو على الشكل <code>[[JavaScript/Function|Function()‎‎]]</code>.
 +
 
 +
==== <code>failCallbacks</code> ====
 +
هو دالة، أو مصفوفة من الدوال، تُستدعى عند رفض الكائن المؤجل وهو على الشكل <code>[[JavaScript/Function|Function()‎‎]]</code>.
 +
 
 +
=== <code>deferred.then( doneCallbacks, failCallbacks [, progressCallbacks ] )‎</code> ===
 +
أُضيف مع الإصدار: [http://api.jquery.com/category/version/1.7/ 1.7]، وحذف مع الإصدار: [http://api.jquery.com/category/version/1.8 1.8].
 +
 
 +
==== <code>doneCallbacks</code> ====
 +
هو دالة، أو مصفوفة من الدوال، تُستدعى عند قبول الكائن المؤجل وهو على الشكل <code>[[JavaScript/Function|Function()‎‎]]</code>.
 +
 
 +
==== <code>failCallbacks</code> ====
 +
هو دالة، أومصفوفة من الدوال، تُستدعى عند رفض الكائن المؤجل وهو على الشكل <code>[[JavaScript/Function|Function()‎‎]]</code>.
 +
 
 +
==== <code>progressCallbacks</code> ====
 +
هو دالة، أومصفوفة من الدوال، تُستدعى عند إشعار تقدُّم الكائن المؤجل وهو على الشكل <code>[[JavaScript/Function|Function()‎‎]]</code>.
 +
 
 +
قبل jQuery 1.8، كان يمكن أن تكون الوسائط دالة أو مصفوفة من الدوال.
 +
 
 +
لجميع التوقيعات، يمكن أن تكون الوسائط <code>null</code> إذا لم تكن هناك رغبة في رد نداء من هذا النوع. بدلاً من ذلك، استخدم <code>[[jQuery/deferred/done|‎.done()]]</code>‎‎ أو <code>[[jQuery/deferred/fail|‎.fail()]]</code>‎‎ أو ‎<code>[[jQuery/deferred/progress|.progress()]]</code>‎‎ لتعيين نوع واحد فقط من رد النداء بدون ترشيح الحالة أو القيم.
 +
 
 +
بدءًا من jQuery 1.8، يُعيد التابع <code>deferred.then()‎‎</code> كائن promise جديدًا يمكنه ترشيح حالة وقيم الكائن المؤجل من خلال دالة، ليحل محل التابع <code>[[jQuery/deferred/pipe|deferred.pipe()‎‎]]</code> المهمل الآن. تُرشِّح الدالتين <code>doneFilter</code> و <code>failFilter</code> حالات قبول ورفض الكائن المؤجل الأصلية وقيمه. ترشح دالة <code>progressFilter</code>  أية استدعاءات إلى تابعي <code>[[jQuery/deferred/notify|notify]]</code> و <code>[[jQuery/deferred/notifyWith|notifyWith]]</code> للكائن المؤجل الأصلي. يمكن لدوال الترشيح هذه إعادة قيمة جديدة تمرر إلى تابعي ‎<code>[[jQuery/deferred/done|.done()]]</code>‎ أو ‎<code>[[jQuery/deferred/fail|.fail()]]</code>‎‎ لدوال ردود نداء الكائن promise، أو يمكنها إعادة كائن آخر يمكن ملاحظته (Deferred و Promise ، وما إلى ذلك) والذي سيمرر حالة وقيم القبول أو الرفض إلى دوال ردود نداء الكائن promise. إذا كانت دالة الترشيح المستخدمة <code>null</code> أو غير محددة، فسيقبل promise أو يرفض بنفس قيم الأصل.
 +
 
 +
تُنفَّذ ردود النداء بالترتيب الذي أُضيفت به. ولما كان التابع <code>deferred.then</code> يعيد Promise، يمكن إعادة الكائن Promise كسلسلة (chain) من خلال التابع، بما في ذلك توابع <code>‎.then()</code>‎‎ الإضافية.
 +
 
 +
=== أمثلة ===
 +
لما كان التابع <code>[[jQuery/jQuery/get|jQuery.get]]</code> يُعيد كائن <code>jqXHR</code>، وهي مشتقة من كائن مؤجل، يمكننا أن نلحق معالجات باستخدام التابع ‎<code>.then</code>.<syntaxhighlight lang="jquery">
 +
$.get( "test.php" ).then(
 +
  function() {
 +
    alert( "$.get succeeded" );
 +
  }, function() {
 +
    alert( "$.get failed!" );
 +
  }
 +
);
 +
</syntaxhighlight>ترشيح قيمة القبول:<syntaxhighlight lang="html">
 +
<!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>
 +
</syntaxhighlight>ترشيح قيمة الرفض:<syntaxhighlight lang="jquery">
 +
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 );
 +
});
 +
</syntaxhighlight>مهام مُعادة كسلسلة (chain) : البيانات المُستردّة من url2 كما هو منصوص عليه في الطلب الأول.<syntaxhighlight lang="jquery">
 +
var request = $.ajax( url, { dataType: "json" } ),
 +
  chained = request.then(function( data ) {
 +
    return $.ajax( url2, { data: { user: data.userId } } );
 +
  });
 +
 +
chained.done(function( data ) {
 +
});
 +
</syntaxhighlight>
  
 
== مصادر ==
 
== مصادر ==
−
[http://api.jquery.com/deferred.state/ صفحة التابع ‎deferred.state()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في توثيق jQuery الرسمي].
+
* [http://api.jquery.com/deferred.then/ صفحة التابع ‎deferred.then()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في توثيق jQuery الرسمي].
 
[[تصنيف:jQuery]]
 
[[تصنيف:jQuery]]
 
[[تصنيف:jQuery Method]]
 
[[تصنيف:jQuery Method]]
 
[[تصنيف:jQuery Deferred]]
 
[[تصنيف:jQuery Deferred]]

المراجعة الحالية بتاريخ 09:21، 24 يونيو 2018

‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎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 ) {
});

مصادر

مجلوبة من "https://wiki.hsoub.com/index.php?title=jQuery/deferred/then&oldid=11151"