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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط
 
(3 مراجعات متوسطة بواسطة مستخدم واحد آخر غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:الفئة: الكائن المؤجل (Deferred Object)}}</noinclude>
+
<noinclude>{{DISPLAYTITLE:الكائن المؤجل (Deferred Object)}}</noinclude>
 
+
قُدِّم الكائن المؤجل في الإصدار jQuery 1.5، وهو كائن أداة قابل للتسلسل ينشأ عن طريق استدعاء التابع <code>jQuery.Deferred()‎‎‎</code>. ويمكنه تسجيل عدة دوال رد اتصال في صفوف رد الاتصال، واستدعاء هذه الصفوف، ونقل حالة النجاح أو الفشل لأي دالة متزامنة أو غير متزامنة.
ي تم تقديمه في الإصدار jQuery 1.5، هو كائن أداة قابل للتسلسل ينشأ عن طريق استدعاء التابع <code>jQuery.Deferred()‎‎‎</code>. ويمكنه تسجيل عدة دوال رد اتصال في صفوف رد الاتصال، واستدعاء هذه الصفوف، ونقل حالة النجاح أو الفشل لأي دالة متزامنة أو غير متزامنة.
 
  
 
يكون الكائن المؤجل قابلاً للتسلسل، مماثلاً للطريقة التي يكون فيها كائن jQuery قابلاً للتسلسل، ولكن له توابعه الخاصة. بعد إنشاء كائن مؤجل، يمكنك استخدام أي من التوابع المذكورة أدناه إما بالتسلسل مباشرة من إنشاء الكائن، أو حفظ الكائن في متغير واستدعاء تابع أو أكثر على ذلك المتغير.
 
يكون الكائن المؤجل قابلاً للتسلسل، مماثلاً للطريقة التي يكون فيها كائن jQuery قابلاً للتسلسل، ولكن له توابعه الخاصة. بعد إنشاء كائن مؤجل، يمكنك استخدام أي من التوابع المذكورة أدناه إما بالتسلسل مباشرة من إنشاء الكائن، أو حفظ الكائن في متغير واستدعاء تابع أو أكثر على ذلك المتغير.
 
+
===<code>[[jQuery/deferred/always|deferred.always()‎]]</code>===
=== <code>deferred.always()‎‎‎</code> ===
+
يُضيف هذا التابع معالجات تُستدعَى عند حل الكائن المؤجل Deferred أو رفضه.
إضافة معالجات تُستدعَى عند حل الكائن المؤجل أو رفضه.
+
===<code>[[jQuery/deferred/catch|‎deferred.catch()‎]]</code>===
 
+
يُضيف هذا التابع معالجات تُستدعى عند رفض الكائن المؤجل Deferred.
=== <code>deferred.catch()‎‎‎</code> ===
+
===<code>[[jQuery/deferred/done|‎deferred.done()‎]]</code>===
إضافة معالجات تُستدعى عند رفض الكائن المؤجل.
+
يُضيف هذا التابع معالجات تستدعى عند حل الكائن المؤجل Deferred.
 
+
===<code>[[jQuery/deferred/fail|deferred‎.fail()‎]]</code>===
=== <code>deferred.done()‎‎‎</code> ===
+
يُضيف هذا التابع معالجات تُستدعى عند رفض الكائن المؤجل Deferred.
إضافة معالجات تستدعى عند حل الكائن المؤجل.
+
=== <code>[[jQuery/deferred/isRejected|deferred.isRejected()‎‎‎‎]]</code> ===
 
 
=== <code>deferred.fail()‎‎‎</code> ===
 
إضافة معالجات تُستدعى عند رفض الكائن المؤجل.
 
 
 
موجود أيضًا في: التوابع المُهملة > التوابع المُهملة في الإصدار 1.7 | التوابع المُزالة.
 
 
 
=== <code>deferred.isRejected()‎‎‎‎</code> ===
 
 
تحديد ما إذا كان الكائن المؤجل قد رُفِض.
 
تحديد ما إذا كان الكائن المؤجل قد رُفِض.
  
 
موجود أيضًا في: التوابع المُهملة > التوابع المُهملة في الإصدار 1.7 | التوابع المُزالة.
 
موجود أيضًا في: التوابع المُهملة > التوابع المُهملة في الإصدار 1.7 | التوابع المُزالة.
  
=== <code>deferred.isResolved()‎‎‎‎</code> ===
+
=== <code>[[jQuery/deferred/isResolved|deferred.isResolved()‎‎‎‎]]</code> ===
 
تحديد ما إذا كان الكائن المؤجل قد قُبِل.
 
تحديد ما إذا كان الكائن المؤجل قد قُبِل.
 
+
===<code>[[jQuery/deferred/notify|‎deferred.notify()‎]]</code>===
=== <code>deferred.notify()‎‎‎</code> ===
+
يستدعي هذا التابع progressCallbacks لكائن مؤجل Deferred بواسطة الوسائط <code>args</code> المعطاة.
استدعاء دالة progressCallbacks لكائن مؤجل بواسطة الوسائط args المعطاة.
+
===<code>[[jQuery/deferred/notifyWith|‎deferred.notifyWith()‎]]</code>===
 
+
يستدعي هذا التابع progressCallbacks لكائن مؤجل Deferred بواسطة الوسائط <code>args</code> والسياق context المعطاة.
=== <code>deferred.notifyWith()‎‎‎</code> ===
+
===<code>[[jQuery/deferred/pipe|deferred‎.pipe()‎]]</code>===
استدعاء دالة progressCallbacks لكائن مؤجل Deferred بواسطة الوسائط args والسياق context المعطاة.
+
تابع أداة يُستخدم لترشيح و/أو تقييد الكائنات المؤجلة Deferreds.
 
+
===<code>[[jQuery/deferred/progress|‎deferred.progress()‎]]</code>===
موجود أيضًا في: التوابع المُهملة > التوابع المُهملة في الإصدار 1.8 {3}|{/3}
+
يُضيف هذا التابع معالجات تستدعى عندما ينتج الكائن المؤجل Deferred إشعارات التقدُّم.
 
+
===<code>[[jQuery/deferred/promise|‎deferred.promise()‎]]</code>===
=== <code>deferred.pipe()‎‎‎</code> ===
+
يُعيد هذا التابع كائن Promise للكائن المؤجل Deferred.
تابع أداة يُستخدم لترشيح و/أو تقييد الكائنات المؤجلة.
+
===<code>[[jQuery/deferred/reject|‎deferred.reject()‎]]</code>===
 
+
يرفُض هذا التابع كائنًا مؤجلًا ويستدعي أي failCallbacks مع الوسيط <code>args</code> المُعطى.
=== <code>deferred.progress()‎‎‎</code> ===
+
===<code>[[jQuery/deferred/rejectWith|deferred‎.rejectWith()‎]]</code>===
إضافة معالجات تُستدعى عندما ينتج الكائن المؤجل إشعارات التقدُّم.
+
يرفض هذا التابع كائنًا مؤجلًا Deferred ويستدعي أي <code>failCallbacks</code> مع سياق <code>context</code> ووسائط <code>args</code> محددة.
 
+
===<code>[[jQuery/deferred/resolve|‎deferred.resolve()‎]]</code>===
=== <code>deferred.promise()‎‎‎</code> ===
+
قبول كائن مؤجل واستدعاء أي <code>doneCallbacks</code> مع الوسائط <code>args</code> المُحدَدة.
إعادة كائن Promise للكائن المؤجل.
+
===<code>[[jQuery/deferred/resolveWith|‎deferred.resolveWith()‎]]</code>===
 
+
يقبل كائن مؤجل ويستدعي أي <code>doneCallbacks</code> مع السياق <code>context</code> والوسائط <code>args</code> المُحدَدة.
=== <code>deferred.reject()‎‎‎</code> ===
+
===<code>[[jQuery/deferred/state|‎deferred.state()‎]]</code>===
رفض كائنًا مؤجلًا واستدعاء أي failCallbacks مع الوسائط args المُحدَدة.
+
يُحدد هذا التابع الحالة الحالية لكائن مؤجل.
 
+
===<code>[[jQuery/deferred/then|‎deferred.then()‎]]</code>===
=== <code>deferred.rejectWith()‎‎‎‎</code> ===
+
يُضيف هذا التابع معالجات تُستدعَى عند قبول الكائن المؤجل أو رفضه أو ما زال قيد التقدم.
رفض كائنًا مؤجلًا واستدعاء أي failCallbacks مع السياق والوسائط args المُحدَدة.
+
===<code>[[jQuery/jQuery/Deferred|‎jQuery.Deferred()‎]]</code>===
 
+
هذه الدالة هي دالةٌ منتجة (factory function) تعيد كائن أداةٍ قابل للتسلسل (chainable utility object) يمكن استعمال مجموعة من التوابع مع هذا الكائن لتسجيل عدَّة دوال رد نداءٍ في طوابير ردود النداء (callback queues)، واستدعاء هذه الطوابير فيما بعد، ونقل حالة النجاح (success state) أو الفشل (failure state) لأي دالة متزامنة (synchronous) أو غير متزامنة (asynchronous).
=== <code>deferred.resolve()‎‎‎‎</code> ===
+
=== <code>[[jQuery/jQuery/when|jQuery.when()‎]]‎‎</code> ===
قبول كائنًا مؤجلًا واستدعاء أي doneCallbacks مع الوسائط args المُحدَدة.
 
 
 
=== deferred.<code>resolveWith</code>()‎‎‎ ===
 
قبول كائنًا مؤجلًا واستدعاء أي doneCallbacks مع السياق الوسائط args المُحدَدة.
 
 
 
=== <code>deferred.state()‎‎‎</code> ===
 
تحديد الحالة الحالية لكائن مؤجل.
 
 
 
=== <code>deferred.then()‎‎‎‎</code> ===
 
إضافة معالجات تُستدعى عند قبول الكائن المؤجل أو رفضه أو إذا ما زال قيد التنفيذ.
 
 
 
=== <code>jQuery.Deferred()‎‎‎‎.</code> ===
 
دالة مصنع تقوم بإعادة كائن أداة متسلسل مع توابع لتسجيل عدة دوال رد النداء في صفوف رد الاتصال، واستدعاء هذه الصفوف، ونقل حالة النجاح أو الفشل لأي دالة متزامنة أو غير متزامنة.
 
 
 
موجود أيضًا في: القلب
 
 
 
=== <code>jQuery.when()‎‎‎</code> ===
 
 
نوفير طريقة لتنفيذ دوال رد الاتصال استنادًا إلى صفر أو أكثر من كائنات قابلة للعمليات Then، وعادة ما تكون الكائنات المؤجلة التي تمثل الأحداث غير المتزامنة.
 
نوفير طريقة لتنفيذ دوال رد الاتصال استنادًا إلى صفر أو أكثر من كائنات قابلة للعمليات Then، وعادة ما تكون الكائنات المؤجلة التي تمثل الأحداث غير المتزامنة.
 
+
===<code>[[jQuery/promise|‎.promise()‎]]</code>===
=== <code>‎.promise()‎‎‎</code> ===
+
يعيد هذا التابع كائنًا من النوع promise عند انتهاء تنفيذ إجراءات ذات نوع محدَّد جميعها، سواءً كانت في الطابور (queued) أم لا، والمرتبطة بالمجموعة؛ وهذا التابع مفيد لمراقبة إكتمال تنفيذ إجراءات معينة.
إعادة كائن Promise لمراقبة الانتهاء من كافة الإجراءات من نوع معين مرتبط بالمجموعة، أو في صفوف الانتظار أو لا.
 
 
 
 
== مصادر ==
 
== مصادر ==
* صفحة الكائن المؤجل (Deferred Object) في توثيق jQuery الرسمي.
+
* [http://api.jquery.com/category/deferred-object/ صفحة الكائن المؤجل (Deferred Object) في توثيق jQuery الرسمي].
 
[[تصنيف:jQuery]]
 
[[تصنيف:jQuery]]
 
[[تصنيف:jQuery Method]]
 
[[تصنيف:jQuery Method]]
 
[[تصنيف:jQuery Deferred]]
 
[[تصنيف:jQuery Deferred]]

المراجعة الحالية بتاريخ 15:02، 19 مارس 2019

قُدِّم الكائن المؤجل في الإصدار jQuery 1.5، وهو كائن أداة قابل للتسلسل ينشأ عن طريق استدعاء التابع jQuery.Deferred()‎‎‎. ويمكنه تسجيل عدة دوال رد اتصال في صفوف رد الاتصال، واستدعاء هذه الصفوف، ونقل حالة النجاح أو الفشل لأي دالة متزامنة أو غير متزامنة.

يكون الكائن المؤجل قابلاً للتسلسل، مماثلاً للطريقة التي يكون فيها كائن jQuery قابلاً للتسلسل، ولكن له توابعه الخاصة. بعد إنشاء كائن مؤجل، يمكنك استخدام أي من التوابع المذكورة أدناه إما بالتسلسل مباشرة من إنشاء الكائن، أو حفظ الكائن في متغير واستدعاء تابع أو أكثر على ذلك المتغير.

deferred.always()‎

يُضيف هذا التابع معالجات تُستدعَى عند حل الكائن المؤجل Deferred أو رفضه.

‎deferred.catch()‎

يُضيف هذا التابع معالجات تُستدعى عند رفض الكائن المؤجل Deferred.

‎deferred.done()‎

يُضيف هذا التابع معالجات تستدعى عند حل الكائن المؤجل Deferred.

deferred‎.fail()‎

يُضيف هذا التابع معالجات تُستدعى عند رفض الكائن المؤجل Deferred.

deferred.isRejected()‎‎‎‎

تحديد ما إذا كان الكائن المؤجل قد رُفِض.

موجود أيضًا في: التوابع المُهملة > التوابع المُهملة في الإصدار 1.7 | التوابع المُزالة.

deferred.isResolved()‎‎‎‎

تحديد ما إذا كان الكائن المؤجل قد قُبِل.

‎deferred.notify()‎

يستدعي هذا التابع progressCallbacks لكائن مؤجل Deferred بواسطة الوسائط args المعطاة.

‎deferred.notifyWith()‎

يستدعي هذا التابع progressCallbacks لكائن مؤجل Deferred بواسطة الوسائط args والسياق context المعطاة.

deferred‎.pipe()‎

تابع أداة يُستخدم لترشيح و/أو تقييد الكائنات المؤجلة Deferreds.

‎deferred.progress()‎

يُضيف هذا التابع معالجات تستدعى عندما ينتج الكائن المؤجل Deferred إشعارات التقدُّم.

‎deferred.promise()‎

يُعيد هذا التابع كائن Promise للكائن المؤجل Deferred.

‎deferred.reject()‎

يرفُض هذا التابع كائنًا مؤجلًا ويستدعي أي failCallbacks مع الوسيط args المُعطى.

deferred‎.rejectWith()‎

يرفض هذا التابع كائنًا مؤجلًا Deferred ويستدعي أي failCallbacks مع سياق context ووسائط args محددة.

‎deferred.resolve()‎

قبول كائن مؤجل واستدعاء أي doneCallbacks مع الوسائط args المُحدَدة.

‎deferred.resolveWith()‎

يقبل كائن مؤجل ويستدعي أي doneCallbacks مع السياق context والوسائط args المُحدَدة.

‎deferred.state()‎

يُحدد هذا التابع الحالة الحالية لكائن مؤجل.

‎deferred.then()‎

يُضيف هذا التابع معالجات تُستدعَى عند قبول الكائن المؤجل أو رفضه أو ما زال قيد التقدم.

‎jQuery.Deferred()‎

هذه الدالة هي دالةٌ منتجة (factory function) تعيد كائن أداةٍ قابل للتسلسل (chainable utility object) يمكن استعمال مجموعة من التوابع مع هذا الكائن لتسجيل عدَّة دوال رد نداءٍ في طوابير ردود النداء (callback queues)، واستدعاء هذه الطوابير فيما بعد، ونقل حالة النجاح (success state) أو الفشل (failure state) لأي دالة متزامنة (synchronous) أو غير متزامنة (asynchronous).

jQuery.when()‎‎‎

نوفير طريقة لتنفيذ دوال رد الاتصال استنادًا إلى صفر أو أكثر من كائنات قابلة للعمليات Then، وعادة ما تكون الكائنات المؤجلة التي تمثل الأحداث غير المتزامنة.

‎.promise()‎

يعيد هذا التابع كائنًا من النوع promise عند انتهاء تنفيذ إجراءات ذات نوع محدَّد جميعها، سواءً كانت في الطابور (queued) أم لا، والمرتبطة بالمجموعة؛ وهذا التابع مفيد لمراقبة إكتمال تنفيذ إجراءات معينة.

 مصادر