عرض مصدر jQuery/jQuery/ajax

<noinclude>{{DISPLAYTITLE:التابع <code>‎‎jQuery.ajax()‎</code>‎ في jQuery}}</noinclude>
== <code>jQuery.ajax( url [, settings ] )‎</code> ==

=== القيم المعادة ===
تعيد كائنًا من النوع jqXHR.

=== الوصف ===
ترسل هذه الدالة طلب ‎(Ajax) HTTP غير متزامن.

=== <code>jQuery.ajax( url [, settings ] )‎</code> ===
أُضيف مع الإصدار: 1.5.

==== <code>url</code> ====
[[JavaScript/String|سلسلة نصية]] تحتوي على العنوان URL المراد إرسال الطلب إليه.

==== <code>settings</code> ====
[[JavaScript/Object|كائن مجرَّد]] (object) يمثِّل مجموعة من الأزواج مفتاح/قيمة التي تضبط طلب Ajax. جميع الإعدادات اختيارية ويمكن تعيين إعدادات افتراضية لأي ضبط باستعمال التابع ‎<code>[[jQuery/jQuery/ajaxSetup|$.ajaxSetup()]]</code>‎. انظر إلى القسم التالي للاطلاع على القائمة الكاملة لجميع الإعدادات.

=== <code>jQuery.ajax( [ settings ] )‎</code> ===
أُضيف مع الإصدار: 1.0.

==== <code>settings</code> ====
[[JavaScript/Object|كائن مجرَّد]] (object) يمثِّل مجموعة من الأزواج مفتاح/قيمة التي تضبط طلب Ajax. جميع الإعدادات اختيارية ويمكن تعيين إعدادات افتراضية لأي ضبط باستعمال التابع ‎<code>[[jQuery/jQuery/ajaxSetup|$.ajaxSetup()]]</code>‎.

الإعدادات المتاحة هي:

===== <code>accepts</code> =====
[[JavaScript/Object|كائن مجرَّد]] يمثل مجموعة من الأزواج مفتاح/قيمة التي تعيِّن <code>dataType</code> المعطى إلى النوع MIME المقابل لها والذي أرسل في ترويسة الطلب Accept، وقيمته الافتراضية تعتمد على <code>dataType</code>. تخبر هذه الترويسة الخادم عن نوع الاستجابة التي تقبلها هي بدورها. على سبيل المثال، تعرِّف الشيفرة التالية نوعًا خاصًا هو <code>mycustomtype</code> ليُرسَل مع الطلب:<syntaxhighlight lang="javascript">
$.ajax({
  accepts: {
    mycustomtype: 'application/x-some-custom-type'
  },
 
  // `mycustomtype` تعليمات من أجل إلغاء تسلسل النوع
  converters: {
    'text mycustomtype': function(result) {
      // افعل شيئًا
      return newresult;
    }
  },
 
  // `mycustomtype` يتوقع أن يعيد الخادم النوع
  dataType: 'mycustomtype'
});
</syntaxhighlight>'''ملاحظة''': ستحتاج إلى تحديد مدخلة متممة لهذا النوع في <code>converters</code> في هذه الحالة من أجل أن يعمل بشكل صحيح.

===== <code>async</code> =====
ترسل جميع الطلبات بشكل غير متزامن افتراضيًّا، إذ إنَّ القيمة الافتراضيَّة لهذا الضبط هي <code>true</code>. إن أردت إرسال الطلبات بشكل متزامن، فغيِّر قيمة هذا الضبط إلى <code>false</code>. لا تدعم الطلبات العابرة للنطاق (cross-domain requests) والطلبات ذات النوع dataType: "jsonp"‎ العمليات المتزامنة. انتبه إلى أنَّ الطلبات المتزامنة قد تسبب توقف المتصفح مؤقتًا عن الاستجابة لأي حدث عندما يكون الطلب فعَّالًا.

بدءًا من الإصدار jQuery 1.8، أهمل استعمال <code>async: false</code> مع الكائن ‎(‎<code>[[jQuery/jQuery/Deferred|$.Deferred]]</code>) jqXHR. يجب عليك استعمال الخيارات success/error/complete لدالة رد النداء (callback) بدلًا من التوابع المقابلة للكائن jqXHR مثل التابع <code>jqXHR.done()</code>‎.

===== <code>beforeSend</code> =====
دالة من الشكل <code>[[JavaScript/Function|Function]]( jqXHR jqXHR, [[JavaScript/Object|Object]] settings )</code>‎ تمثل دالة رد النداء التي ستُنفَّذ قبل إرسال الطلب لتعديل الكائن jqXHR (في الإصدار jQuery 1.4.x، يكون XMLHTTPRequest) قبل إرساله.

استعمل هذه الدالة من أجل ضبط ترويسات مخصَّصة. تقبل هذه الدالة أن يمرر إليها الكائن <code>jqXHR</code> والكائن <code>settings</code> كوسائط. تُعدُّ هذه الدالة حدثًا من أحداث Ajax، وسيلغى الطلب إن أعادت الدالة القيمة <code>false</code>.

بدءًا من الإصدار jQuery 1.5، سيستدعى الضبط <code>beforeSend</code> بغض النظر عن نوع الطلب.

===== <code>cache</code> =====
[[JavaScript/Object|قيمة منطقيَّة]] (Boolean)، وقيمته الافتراضيَّة هي <code>true</code> في جميع أنواع الطلبات باستثناء النوع 'script' والنوع 'jsonp' التي تكون القيمة الافتراضيَّة فيها هي <code>false</code>. إن ضُبطت قيمته إلى <code>false</code>، فستجبر المتصفح حينها على عدم تخزين الصفحات المطلوبة.

'''ملاحظة''': لن يعمل ضبط قيمة <code>cache</code> إلى <code>false</code> بشكل صحيح إلا في الطلب HEAD والطلب GET، إذ يعمل بإضافة ‎ <code>_={timestamp}‎</code> إلى معاملات الطلب GET. ليس هنالك حاجة لهذا الضبط في أنواع الطلبات الأخرى، ويستثنى في هذه الحالة المتصفح IE8 عندما يرسل طلب POST لعنوان URL قد أرسل إليه طلب مسبقًا باستعمال GET.

===== <code>complete</code> =====
دالة من الشكل <code>[[JavaScript/Function|Function]]( jqXHR jqXHR, [[JavaScript/String|String]] textStatus )</code>‎ تمثل الدالة التي ستُستدعى عند انتهاء الطلب (بعد تنفيذ رد النداء success ورد النداء error). تقبل هذه الدالة أن يمرَّر إليها وسيطين هما: الكائن jqXHR (في الإصدار jQuery 1.4.x، يكون XMLHTTPRequest)، وسلسلة نصية تصنِّف حالة الطلب ("success"، أو "notmodified"، أو "nocontent"، أو "error"، أو "timeout"، أو "abort"، أو "parsererror").

بدءًا من الإصدار jQuery 1.5، أصبح الضبط <code>complete</code> يقبل مصفوفة من الدوال، إذ ستستدعى حينئذٍ كل دالة على التوالي. تُعدُّ هذه الدالة أو الدوال حدثًا من أحداث Ajax.

===== <code>contents</code> =====
[[JavaScript/Object|كائن مجرَّد]] يمثل مجموعة من الأزواج سلسلة نصية/تعبير نمطي (regular expression) التي ستحدِّد كيفية تحليل jQuery للرد عند إعطاء نوع محتواه. (أضيف مع الإصدار: 1.5).

===== <code>contentType</code> =====
[[JavaScript/Boolean|قيمة منطقيَّة]] أو سلسلة نصية تحدِّد نوع محتوى البيانات المرسلة إلى الخادم، وقيمته الافتراضيَّة هي "application/x-www-form-urlencoded; charset=UTF-8" التي تناسب أغلب الحالات. إن مرَّرت نوع البيانات إلى <code>‎$.ajax()‎</code> بشكل صريح، فسيُرسل إلى الخادم حينئذٍ حتى لو لم يكن هنالك بيانات لإرسالها. بدءًا من الإصدار jQuery 1.6، يمكن تمرير القيمة <code>false</code> لإخبار jQuery بعدم ضبط أية ترويسة لنوع البيانات.

'''ملاحظة''': أوصى المعيار W3C XMLHttpRequest باستعمال ترميز المحارف UTF-8 دومًا. لن يجبر تحديد ترميز آخر للمحارف المتصفح على تغيير الترميز.

'''ملاحظة''': في الطلبات العابرة للنطاق، اضبط نوع المحتوى إلى أي نوع آخر باستثناء القيمة <code>application/x-www-form-urlencoded</code> أو القيمة <code>multipart/form-data</code> أو القيمة text/plain التي تجبر المتصفح على إرسال طلب preflight OPTIONS إلى الخادم.

===== <code>context</code> =====
[[JavaScript/Object|كائن مجرد]] يمثل محتوى جميع ردود النداء المتعلقة بالنوع Ajax. المحتوى هو كائن يمثل إعدادات Ajax المستعملة في الاستدعاء افتراضيًّا (يُدمج ‎<code>$.ajaxSettings</code> مع الإعدادات الممرَّرة إلى ‎<code>$.ajax</code>). على سبيل المثال، سيؤدي تحديد عنصر DOM كمحتوى إلى إسناد هذا المحتوى إلى دالة رد النداء complete للطلب كما موضح في المثال التالي:<syntaxhighlight lang="javascript">
$.ajax({
  url: "test.html",
  context: document.body
}).done(function() {
  $( this ).addClass( "done" );
});
</syntaxhighlight>

===== <code>converters</code> =====
[[JavaScript/Object|كائن مجرَّد]] يحتوي على محولات أنواع البيانات (dataType-to-dataType)، إذ تمثِّل كلُّ قيمة محوِّل دالةً تعيد القيمة المحولة للرد. القيمة الافتراضيَّة هي ‎{"* text": window.String, "text html": true, "text json": jQuery.parseJSON, "text xml": jQuery.parseXML}‎. (أضيف مع الإصدار: 1.5).

===== <code>crossDomain</code> =====
[[JavaScript/Boolean|قيمة منطقيَّة]]، وقيمته الافتراضيَّة هي <code>false</code> من أجل طلبات من نفس النطاق (same-domain) و true من أجل الطلبات اعلابرة للنطاقات (cross-domain).

إن أردت إجبار الطلب على عبور النطاق (crossDomain request) مثل JSONP في نفس النطاق، فغير قيمة هذا الضبط إلى <code>true</code>؛ هذا سيسمح للخادم بإعادة توجيه الطلب مثلًا إلى نطاق آخر. (أضيف مع الإصدار: 1.5).

===== <code>data</code> =====
[[JavaScript/Object|كائن مجرَّد]] أو [[JavaScript/String|سلسلة نصية]] أو [[JavaScript/Array|مصفوفة]] تمثل البيانات المراد إرسالها إلى الخادم. تحول البيانات إلى سلسلة إستعلامات نصية إن لم تعطَ بشكل سلسلة نصية، وتضاف إلى عنوان URL في طلبات GET. انظر الضبط <code>processData</code> إن أردت منع هذه العملية التلقائية.

إن أعطي هذا الضبط على شكل كائن، فيجب أن يكون أزواجًا من مفتاح/قيمة. أمَّا إن أعطي على شكل مصفوفة، فسترمِّز jQuery عدَّة قيم بنفس المفتاح بناءً على قيمة الضبط traditional (تجده في الأسفل).

===== <code>dataFilter</code> =====
دالة من الشكل <code>[[JavaScript/Function|Function]]( [[JavaScript/String|String]] data, [[JavaScript/String|String]] type )‎</code> تعيد أي شيء، وتُستعمَل لمعالجة بيانات الرد الصرفة للكائن XMLHttpRequest. تُجرِي هذه الدالة عمليَّة ترشيح مسبقة لبيانات الرد وكأنها تنظِّف وتعقِّم تلك البيانات قبل أن تعيدها إليك. تقبل الدالة وسيطين هما: البيانات الصرفة المعادة من الخادم، والمعامل <code>dataType</code>.

===== <code>dataType</code> =====
[[JavaScript/String|سلسلة نصية]] تمثل نوع البيانات التي تتوقع أن تُعاد من الخادم. إن لم يحدَّد أي نوع، فستحاول jQuery أن تخمِّن نوع البيانات بالاعتماد على نوع MIME للرد (سيعطي النوع XML في MIME مثلًا القيمة XML، وسينتج النوع JSON في الإصدار 1.4 كائن JavaScript، وسيؤدي النوع script إلى تنفيذ الشيفرة المعادة في الإصدار 1.4، وسيعاد أي شيء آخر كسلسلة نصية). القيمة الافتراضيَّة لهذا الضبط هي Intelligent Guess (xml, json, script, or html)‎. الأنواع المتاحة (مُرِّرت النتيجة التي ستُمرَّر كأوّل وسيط لدالة رد النداء) هي:
* "XML": يعاد مستند XML يمكن أن تعالجه jQuery.
* "html" يعاد محتوى HTML كنص عادي، وتنفَّذ الشيفرة الموجودة ضمن عناصر <code>[[HTML/script|<script>]]</code> عند إضافتها إلى DOM.
* "script": يُعدُّ الرد على أنَّه شيفرة JavaScript، ويعاد كنص عادي. يفضل تعطيل التخزين (caching) بإضافة معامل سلسلة الاستعلام النصية <code>‎_=[TIMESTAMP]</code>‎ إلى الرابط URL إلا إذا غُيِّرت قيمة الضبط <code>cache</code> إلى القيمة <code>true</code>.  '''ملاحظة''': سيحول هذا النوع الطلبات POST إلى GET من أجل الطلبات ذات النطاق البعيد (remote-domain requests).
* "json": يُعدُّ الرد على أنَّه JSON، ويعاد ككائن JavaScript. تنفَّذ طلبات "json" العابرة للنطاقات (Cross-domain ) التي تملك دالة رد نداء نائبة (callback placeholder)، مثل <code>‎?callback=?</code>‎، باستعمال JSONP ما لم يحتوي الطلب على القيمة <code>jsonp: false</code> المعطاة لضبط إعداداته. تحلَّل بيانات JSON بأسلوب دقيق وصارم، إذ يُرفَض أي جزء مشوه من JSON ويطلق خطأ عند التحليل.  بدءًا من الإصدار jQuery 1.9، سيرفض الرد الفارغ أيضًا، إذ يجب على الخادم أن يعيد ردًا يحوي <code>null</code> أو <code>{}</code> على الأقل. (تصفح [[JavaScript/JSON|هذا القسم]] للمزيد من المعلومات حول تنسيق JSON الصحيح).
* "jsonp": يحمَّل الرد المعاد في كتلة JSON باستعمال JSONP. أضف العبارة <code>?callback=?</code> إلى نهاية العنوان URL لتحديد رد النداء. يفضل تعطيل التخزين (caching) بإضافة معامل سلسلة الاستعلام النصية <code>‎_=[TIMESTAMP]‎</code> إلى الرابط URL إلا إذا غُيِّرت قيمة الضبط <code>cache</code> إلى القيمة <code>true</code>.
* "text": سلسلة نصية تحتوي على نص عادي (plain text).
* بدءًا من الإصدار jQuery 1.5، أصبح بإمكان jQuery تحويل نوع البيانات <code>dataType</code> من النوع التي استقبلته والمحدد في ترويسة نوع المحتوى (Content-Type header) إلى أي نوع تحتاجه عبر تمرير قيم متعددة مفصولة بفراغ لهذا الضبط. إن أردت مثلًا أن يعامل رد نصي على أنَّه XML، فاستعمل القيمة "text xml" مع الضبط <code>dataType</code> ببساطة. يمكنك أيضًا أن تجعل رد JSONP يعاد كنص ويفسر من قبل jQuery على أنَّه XML من خلال استعمال "jsonp text xml". بطريقة مشابهة، يمكن اختزال السلسلة النصية إلى "jsonp xml" عوضًا عن ذلك، إذ ستجرى محاول حينئذٍ للتحويل من jsonp إلى xml. إن فشلت هذه العمليَّة، فسيحول من jsonp إلى text ثمَّ من text إلى xml.

===== <code>error</code> =====
دالة من الشكل <code>[[JavaScript/Function|Function]]( jqXHR jqXHR, [[JavaScript/String|String]] textStatus, [[JavaScript/String|String]] errorThrown )</code>‎ تستدعى عند فشل الطلب. تقبل هذه الدالة ثلاثة وسائط هي: كائن jqXHR (في الإصدار jQuery 1.4.x، يكون XMLHttpRequest)، وسلسلة نصية تصف نوع الخطأ الذي حصل، سلسلة نصية اختيارية تحتوي تمثيلًا نصيًا لرسالة الخطأ. القيم المتاحة للوسيط الثاني (بجانب القيمة null) هي: "timeout"، و "error"، و "abort"، و "parsererror". عند حصول خطأ HTTP، يتلقى الوسيط errorThrown الجزء النصي المتعلق بحالة HTTP مثل الجزء "Not Found" أو "Internal Server Error".

بدءًا من الإصدار jQuery 1.5، أًصبح بإمكان الضبط <code>error</code> قبول مصفوفة من الدوال، إذ ستستدعى تلك الدوال على التوالي. تُعدُّ هذه الدالة أو الدوال حدثًا من أحداث Ajax.

'''ملاحظة''': لا يستدعى معالج الحدث هذا مع السكربت العابر للنطاق والطلب JSONP العابر للنطاق أيضًا.

===== <code>global</code> =====
[[JavaScript/Boolean|قيمة منطقيَّة]] (Boolean) تحدِّد إن كان يسمح باستدعاء معالجات الحدث Ajax العامة مع الطلب حينئذ. القيمة الافتراضية هي <code>true</code> وعند تغييرها إلى القيمة <code>false</code>، ستُمنَع معالجات الحدث العامة -مثل ajaxStart أو ajaxStop- من استدعائها. هذا الضبط مفيد، إذ يستعمل للتحكم بمختلف أحداث Ajax.

===== <code>hearders</code> =====
كائن يتكون من أزواج من مفتاح/قيمة تمثل ترويسات إضافيَّة يراد إرسالها مع الطلبات باستعمال XMLHttpRequest. تضاف الترويسة X-Requested-With: XMLHttpRequest دومًا ولكن يمكن تغيير قيمتها الافتراضيَّة XMLHttpRequest هنا. يمكن أن تستبدل القيم في الضبط <code>headers</code> عبر استعمال دالة الضبط <code>beforeSend</code>. القيمة الافتراضيَّة هي {}. (أضيف مع الإصدار: 1.5).

===== <code>ifModified</code> =====
[[JavaScript/Boolean|قيمة منطقيَّة]] تسمح للطلب بأن يكون ناجحًا إن تغيَّر الرد عن الرد المعاد من آخر طلب، وهذا يتم عبر التحقُّق من ترويسة Last-Modified في HTTP. القيمة الافتراضيَّة هي <code>false</code> وتشير إلى تجاهل الترويسة. في الإصدار jQuery 1.4، يتحقَّق هذا الضبط أيضًا من 'etag' الذي يحدِّده الخادم لتتبع البيانات غير المعدلة.

===== <code>isLocal</code> =====
[[JavaScript/Boolean|قيمة منطقيَّة]] (Boolean) تسمح للبيئة الحالية أن يُعترَف بها كبيئة عامة، مثل نظام الملفات (filesystem)، حتى ولو لم تعترف jQuery بها كذلك افتراضيًّا. البروتوكولات التي يعترف بأنَّها عامة حاليًا هي: file، و ‎*-extension، و widget. إن احتجت إلى تعديل هذا الضبط، فينصح بشدة القيام بذلك مرةً واحدةً عبر التابع ‎<code>[[jQuery/jQuery/ajaxSetup|$.ajaxSetup()]]</code>‎. القيمة الافتراضيَّة تعتمد على موقع البروتوكول الحالي. (أضيف مع الإصدار: 1.5.1).

===== <code>jsonp</code> =====
[[JavaScript/String|سلسلة نصية]] أو [[JavaScript/Boolean|قيمة منطقيَّة]] تُستعمَل لتجاهل اسم دالة رد النداء في طلب JSONP. ستستخدم هذه القيمة عوضًا عن 'callback' في الجزء 'callback=?‎' من سلسلة الاستعلام النصية في العنوان URL. إن استعملنا القيمة {jsonp:'onJSONPLoad'‎} مثلًا، فستكون النتيجة 'onJSONPLoad=?‎' التي تمرَّر إلى الخادم.

بدءًا من الإصدار jQuery 1.5، يؤدي تعيين قيمة الضبط <code>jsonp</code> إلى القيمة <code>false</code> إلى منع jQuery من إضاف السلسلة النصية "‎?callback" إلى العنوان URL أو محاول استعمال "‎=?‎‎" للتحويل. في هذه الحالة، يجب عليك تعيين قيمة الضبط <code>jsonpCallback</code> بشكل صريح مثل <code>{ jsonp: false, jsonpCallback: "callbackName"‎ }</code>. إن لم تكن واثقًا من الذي أرسل إليه طلبات Ajax، فغيِّر قيمة الضبط <code>jsonp</code> إلى false لزيادة الحماية.

===== <code>jsonpCallback</code> =====
[[JavaScript/String|سلسلة نصية]] أو دالة من الشكل <code>[[JavaScript/Function|Function()‎]]</code> تعيد سلسلة نصية تحدِّد اسم دالة رد النداء لطلب JSONP. ستسخدم هذه القيمة عوضًا عن الاسم العشوائي الذي تولِّده jQuery تلقائيًا. الأفضل أحيانًا أن ندع jQuery تولد اسمًا فريدًا، إذ ستسهِّل بذلك علينا إدارة الطلبات بتوفير دوال رد نداء ومعالجات للأخطاء. قد تحتاج إلى تحديد دالة رد النداء عندما تريد تفعيل تخزين الطلبات GET في المتصفح.

بدءًا من الإصدار jQuery 1.5، يمكنك أيضًا استعمال دالةً مع هذا الضبط والتي تضبط قيمته حينئذٍ إلى القيمة التي تعيدها.

===== <code>method</code> =====
[[JavaScript/String|سلسلة نصية]] تحدِّد طريقة الإرسال عبر HTTP (أي HTTP method) التي ستستعمل مع الطلب مثل "POST" أو "GET" أو "PUT". (أضيف مع الإصدار: 1.9.0).

===== <code>mimeType</code> =====
[[JavaScript/String|سلسلة نصية]] تمثل نوع MIME الذي سيحل محل النوع XHR. (أضيف مع الإصدار: 1.5.1).

===== <code>password</code> =====
[[JavaScript/String|سلسلة نصية]] تمثل كلمة المرور المراد استعمالها مع الكائن XMLHttpRequest عند الرد على طلب المصادقة HTTP للسماح بالوصول.

===== <code>processData</code> =====
[[JavaScript/Boolean|قيمة منطقيَّة]]. ستعالج البيانات الممرَّرة إلى الضبط <code>data</code> ككائن (أي شيء خلاف سلسلة نصية) وتحوَّل إلى سلسلة استعلام نصية افتراضيًّا بما يتناسب مع نوع المحتوى الافتراضي "application/x-www-form-urlencoded". إن أردت إرسال DOMDocument أو أية بيانات دون معالجتها، فغيِّر قيمة هذا الضبط إلى <code>false</code>.

===== <code>scriptCharset</code> =====
[[JavaScript/String|سلسلة نصية]]. يطبق هذا الضبط عند نقل السكربتات (مثل الطلبات العابرة للنطاق مع تعيين القيمة "script" أو القيمة "jsonp" للضبط dataType والقيمة "GET" للضبط Method) بضبط قيمة الخاصِّيَّة <code>charset</code> في العنصر <code>[[HTML/script|<script>]]</code> إلى القيمة نفسها المعيَّنة في الطلب. هذا الضبط مفيد، إذ يستعمل عندما يختلف ترميز المحارف في الصفحة الحالية عن الترميز المحدَّد في السكربت البعيد.

===== <code>statusCode</code> =====
كائن يحتوي على رموز HTTP الرقمية والدوال التي يراد استدعاؤها عندما يعيد الرد رمزًا مقابلًا لها. على سبيل المثال، ستُظهِر الشيفرة التالية تنبيهًا عندما يكون رمز حالة الرد المعاد هي 404:<syntaxhighlight lang="javascript">
$.ajax({
  statusCode: {
    404: function() {
      alert( "لم يعثر على الصفحة" );
    }
  }
});

</syntaxhighlight>إن نجح الطلب، فستأخذ دوال رمز الحالة المعاملات نفسها التي تأخذها دالة رد النداء الناجحة. أما إن حصل خطأ وأعيدت نتيجة هذا الخطأ (من ضمنها إعادة التحويل 3xx)، فستأخذ تلك الدوال المعاملات نفسها الممررة إلى رد النداء error. (أضيف مع الإصدار: 1.5).

===== <code>success</code> =====
دالة من الشكل <code>[[JavaScript/Function|Function]]( Anything data, [[JavaScript/String|String]] textStatus, jqXHR jqXHR )</code>‎ تستدعى إن نجح الطلب. تقبل هذه الدالة أن يمرر إليها ثلاثة وسائط هي: البيانات المعادة من الخادم منسقةً وفقًا لقيمة الضبط <code>dataType</code> أو دالة رد النداء <code>dataFilter</code> إن أعطيت، وسلسلة نصية تصف حالة الطلب، والكائن jqXHR (في الإصدار jQuery 1.4.x يكون XMLHttpRequest).

بدءًا من الإصدار jQuery 1.5، أصبح الضبط <code>success</code> يقبل مصفوفة من الدوال.

تُعدُّ هذه الدالة أو الدوال حدثًا من أحداث Ajax.

===== <code>timeout</code> =====
عددًا يمثل زمن انتهاء مهلة الطلب وواحدته ميلي ثانية. القيمة 0 تعني أنه لا يوجد مهلة لانتظار الطلب بعد إرساله. تعيين قيمة لهذا الضبط سيؤدي إلى إهمال أي مهلة زمنية عامة ضبطت باستعمال ‎<code>[[jQuery/jQuery/ajaxSetup|$.ajaxSetup()‎]]</code>. يبدأ حساب المهلة الزمنية لحظة استدعاء <code>‎$.ajax</code>. إن كان هنالك طلبات أخرى قيد الإرسال ولم يكن هنالك اتصالٌ متوافر للمتصفح، فمن المحتمل أن تنفد المهلة الزمنية المحددة للطلب حتى قبل أن يرسل.

في الإصدار jQuery 1.4.x وما قبله، انتبه إلى أنه لن يعود الكائن XMLHttpRequest صالحًا إن نفدت المهلة الزمنية المحدَّد للطلب.

الوصول إلى أحد عناصر كائنٍ قد يؤدي إلى رمي استثناءٍ.

في المتصفح Firefox 3.0+‎ فقط، لا تُلغى طلبات السكربتات وطلبات JSONP عند نفاد المهلة الزمنية، إذ سيعمل السكربت آنذاك حتى لو وصل بعد نفاد الوقت.

===== <code>traditional</code> =====
[[JavaScript/Boolean|قيمة منطقية]] (Boolean). هذا الضبط مفيد في حال أردت استعمال النمط التقليدي لترميز المعاملات (param serialization).

===== <code>type</code> =====
يعدُّ هذا الضبط اسمًا بديلًا للضبط <code>method</code>. يجب عليك استعماله إن كنت تستخدم إصدارًا ما قبل jQuery 1.9.0. القيمة الافتراضيَّة هي 'GET'.

===== <code>url</code> =====
[[JavaScript/String|سلسلة نصية]] تحتوي على العنوان URL الذي سيرسل إليه الطلب. القيمة الافتراضيَّة له هي عنوان الصفحة الحالية.

===== <code>username</code> =====
[[JavaScript/String|سلسلة نصية]] تمثل اسم المستخدم الذي سيستعمل مع الكائن XMLHttpRequest عند الرد على طلب المصادقة HTTP للسماح بالوصول.

===== <code>xhr</code> =====
دالة من الشكل <code>[[JavaScript/Function|Function()‎]]</code> تمثل دالة رد النداء (callback) المراد استعمالها لإنشاء الكائن  XMLHttpRequest. القيمة الافتراضيَّة هي الكائن ActiveXObject إن كان ذلك متاحًا (في المتصفح IE)، أو الكائن XMLHttpRequest خلاف ذلك. يمكنك استعمال هذا الضبط لاستعمال نسخة بديلة عن الكائن XMLHttpRequest بالشكل الذي تريده أو يمكن تجاهل هذه الميزة والاستفادة من الإعدادات الافتراضيَّة.

===== <code>xhrFields</code> =====
كائن يحتوي على أزواجٍ من «اسم المجال/قيمة المجال» التي تضبط خاصيات الكائن XHR الأساسي. على سبيل المثال، يمكنك استعمال هذا الضبط لتعيين القيمة <code>true</code> إلى <code>withCredentials</code> للطلبات العابرة للنطاق إن احتجت إلى ذلك.<syntaxhighlight lang="javascript">
$.ajax({
   url: a_cross_domain_url,
   xhrFields: {
      withCredentials: true
   }
});

</syntaxhighlight>في الإصدار jQuery 1.5، لم تنتشر (propagate) الخاصِّيَّة <code>withCredentials</code> إلى الكائن XHR الأساسي، لذا ستتجاهل الطلبات CORS التي تحتاج لها هذه الراية (flag)؛ ولهذا السبب، ينصح بشدة استعمال الإصدار jQuery 1.5.1 وما بعده التي توجب استعمال تلك الخاصِّيَّة. (أضيف مع الإصدار: 1.5.1).

ترتكز جميع طلبات Ajax المرسلة باستعمال jQuery على الدالة ‎<code>$.ajax()</code>‎. ليس هنالك داعٍ في أغلب الأحيان إلى استدعاء هذه الدالة مباشرةً، إذ تتوافر بدائل عديدة ذات مستوى أعلى (higher-level) من الأسهل استعمالها مثل الدالة <code>[[jQuery/jQuery/get|‎$.get()‎]]</code> والتابع [[jQuery/load|‎.‎load()‎]] وغيرها. كلما قل استعمال الخيارات والإعدادات المطلوب ضبطها، كان استعمال الدالة ‎<code>$.ajax()</code>‎ أسهل وأكثر مرونة.

أبسط شكل لاستعمال الدالة ‎<code>$.ajax()</code>‎ هو استدعاؤها دون أية وسائط مثل:<syntaxhighlight lang="javascript">
$.ajax();
</syntaxhighlight>'''ملاحظة''': يمكن ضبط الإعدادات وجعلها افتراضيَّة على الصعيد العام باستعمال الدالة ‎<code>[[jQuery/jQuery/ajaxSetup|$.ajaxSetup()‎]]</code>.

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

=== الكائن jqXHR ===
الكائن XMLHttpRequest (أو jqXHR) المعاد باستعمال ‎<code>$.ajax()</code>‎ بدءًا من الإصدار jQuery 1.5 هو مجموعةٌ حاويةٌ (superset) للكائن XMLHttpRequest الأساسي للمتصفح. يحتوي الكائن مثلًا على الخاصِّيَّة <code>responseText</code> والخاصِّيَّة <code>responseXML</code> بالإضافة إلى التابع <code>getResponseHeader()‎</code>. عند اختيار آلية للنقل غير XMLHttpRequest (مثل الوسم <code>[[HTML/script|<script>]]</code> للطلب JSONP)، فسيحاكي الكائن jqXHR الكائن XHR الأساسي وظيفيًّا حيث أمكنه ذلك.

بدءًا من الإصدار jQuery 1.5.1، يمكن أن يحتوي الكائن jqXHR على التابع <code>overrideMimeType()</code>‎ أيضًا (كان هذا متاحًا في الإصدار jQuery 1.4.x أيضًا ولكنه أزيل مؤقتًا في الإصدار jQuery 1.5). قد يستعمل التابع <code>overrideMimeType()‎</code> في دالة رد النداء <code>beforeSend()</code>‎ لتعديل ترويسة نوع المحتوى (content-type header) للرد مثلًا:<syntaxhighlight lang="javascript">
$.ajax({
  url: "https://fiddle.jshell.net/favicon.png",
  beforeSend: function( xhr ) {
    xhr.overrideMimeType( "text/plain; charset=x-user-defined" );
  }
})
  .done(function( data ) {
    if ( console && console.log ) {
      console.log( "Sample of data:", data.slice( 0, 100 ) );
    }
  });

</syntaxhighlight>تنفِّذ (implement) الكائنات jqXHR المعادة عن طريق ‎<code>$.ajax()</code>‎ بدءًا من الإصدار jQuery 1.5 الواجهة [[jQuery/promise|Promise]] بإعطائها جميع الخاصيات، والتوابع، وسلوك [[jQuery/promise|Promise]] (ارجع إلى توثيق الكائن [[jQuery/deferred|Deferred]] للمزيد من المعلومات). تأخذ هذه التوابع دالة واحدة أو أكثر كوسائط التي تستدعى عندما ينتهي طلب ‎<code>$.ajax()‎</code>. يسمح لك هذا بإسناد ردود نداء متعدِّدة في طلب وحيد وحتى إسناد ردود نداء بعد أن يكون الطلب قد اكتمل. (إن اكتمل الطلب مسبقًا، فسيُطلق رد النداء مباشرةً). هنالك عدة توابع [[jQuery/promise|Promise]] متاحة لاستعمالها مع الكائن jqXHR من ضمنها:
* <code>jqXHR.done(function( data, textStatus, jqXHR ) {});‎</code>  شكلٌ آخرٌ لإنشاء دالة رد النداء للضبط <code>success</code>. ارجع إلى صفحة التابع <code>[[jQuery/deferred/done|deferred.done()]]</code>‎ للاطلاع على مزيد من التفاصيل حول كيفية التنفيذ.
* <code>jqXHR.fail(function( jqXHR, textStatus, errorThrown ) {});‎</code>  شكلٌ آخرٌ لإنشاء دالة رد النداء للضبط <code>error</code>، إذ حل التابع <code>‎.‎fail()‎</code> مكان التابع ‎.<code>error()</code>‎ المهمل. ارجع إلى صفحة التابع <code>[[jQuery/deferred/fail|deferred.fail()]]</code>‎ للاطلاع على المزيد من التفاصيل حول كيفية التنفيذ.
* <code>jqXHR.always(function( data|jqXHR, textStatus, jqXHR|errorThrown ) { });‎</code>  (أضيف مع الإصدار: 1.6)  شكلٌ آخرٌ لإنشاء دالة رد النداء للضبط <code>complete</code>، إذ حل التابع <code>‎.always()‎</code> مكان التابع ‎<code>.complete()‎</code> المهمل.  عند الرد على طلب ناجح، تكون وسائط الدالة مماثلة تمامًا لوسائط التابع ‎<code>.done()</code>‎ وهي: السلسلة النصية <code>data</code>، والسلسلة النصية <code>textStatus</code>، والكائن <code>jqXHR</code>. أمَّا في حالة فشل الطلب، ستكون الوسائط نفسها الوسائط الممررة إلى التابع ‎<code>.fail()</code>‎ وهي: الكائن <code>jqXHR</code>، والسلسلة النصية <code>textStatus</code>، والسلسلة النصية <code>errorThrown</code>. ارجع إلى صفحة التابع <code>[[jQuery/deferred/always|deferred.always()‎]]</code> للاطلاع على المزيد من التفاصيل حول كيفية التنفيذ.
* <code>jqXHR.then(function( data, textStatus, jqXHR ) {}, function( jqXHR, textStatus, errorThrown ) {});‎</code>  مزيجٌ لوظيفة التابع <code>‎.done()</code>‎ والتابع ‎<code>.fail()‎</code>، إذ يسمح (بدءًا من الإصدار jQuery 1.8) بتعديل الكائن [[jQuery/promise|Promise]]. ارجع إلى التابع <code>[[jQuery/deferred/done|deferred.then()‎]]</code> للاطلاع على المزيد من التفاصيل حول كيفية التنفيذ.
'''ملاحظة''': حذفت دوال ردود النداء <code>jqXHR.success()</code>‎، و <code>jqXHR.error()‎</code>، و <code>jqXHR.complete()‎</code> بدءًا من الإصدار 3.0. يمكنك استعمال <code>jqXHR.done()</code>‎، و <code>jqXHR.fail()‎</code>، و <code>jqXHR.always()</code>‎ عوضًا عنها.<syntaxhighlight lang="javascript">
// إسناد معالجات أحداثٍ بعد إنشاء الطلب مباشرةً ,
// لهذا الطلب jqXHR وحفظ الكائن
var jqxhr = $.ajax( "example.php" )
  .done(function() {
    alert( "تم بنجاح" );
  })
  .fail(function() {
    alert( "حصل خطأ" );
  })
  .always(function() {
    alert( "اكتمل بنجاح" );
  });
 
// أنجز أعمالًا أخرى هنا
 
//  أخرى للطلب complete تعيين دالة
jqxhr.always(function() {
  alert( "اكتمل مرة أخرى بنجاح" );
});
</syntaxhighlight>يشير <code>this</code> ضمن جميع دوال ردود النداء إلى الكائن المعطى في الوسيط <code>context</code> الممرَّر إلى <code>‎$.ajax()‎</code> مع الإعدادات <code>settings</code> المعطاة. إن لم يعطَ المعامل <code>context</code>، فسيشر <code>this</code> إلى الإعدادات <code>settings</code> نفسها.

لتحقيق التوافقيَّة الرجوعيَّة (backward compatibility) مع الكائن XMLHttpRequest، سيعرض الكائن jqXHR الخاصِّيَّات والتوابع التالية:
* <code>readyState</code>
* <code>responseXML</code> و/أو <code>responseText</code> عندما يُرَدُّ على الطلب الأساسي بإعادة مستند XML و/أو text على التوالي.
* <code>status</code>
* <code>statusText</code>
* <code>abort( [ statusText ] )‎</code>
* <code>getAllResponseHeaders()‎</code> كسلسلة نصية.
* <code>getResponseHeader( name )‎</code>
* <code>overrideMimeType( mimeType )‎</code>
* <code>setRequestHeader( name, value )</code>‎ التي اشتقت من المعيار القياسي مع تبديل القيمة الجديد مكان القيمة القديمة بدلًا من ربط القيمة الجديدة بالقيمة القديمة.
* <code>statusCode( callbacksByStatusCode )‎</code>
لا تتوافر الآلية <code>onreadystatechange</code>، إذ تغطي التوابع <code>done</code>، و <code>fail</code>، و <code>always</code>، و <code>statusCode</code> كل ما يمكن أن تتخيله.

=== طوابير دوال ردود النداء ===
تقبل الإعدادات <code>beforeSend</code>، و <code>error</code>، و <code>dataFilter</code>، و <code>success</code> جميعها دوال ردود نداء والتي تُستدعَى في الأوقات الملائمة.

بدءًا من الإصدار jQuery 1.5، يمكن أن تدار خطافات (hooks) دوال النداء <code>fail</code>، و <code>done</code>، و <code>always</code> -بدءًا من الإصدار jQuery 1.6- باستعمال طوابير من النوع "أدخل أولًا وأخرج أولًا" (first-in first-out queues أو اختصارًا fifo queues)، إذ يسمح ذلك بربط أكثر من دالة رد نداء بخطاف. انظر إلى توابع الكائن [[jQuery/deferred|Deferred]] التي تنفَّذ داخليًا لخطافات دوال ردود النداء <code>‎$.ajax()‎</code> هذه.

خطافات دوال ردود النداء التي تتيحها ‎<code>$.ajax‎()‎</code> هي كما يلي:
# دالة رد النداء للضبط <code>beforeSend</code>. تقبل أن يمرَّر  إليها الكائن jqXHR والكائن settings كوسائط.
# دالة رد النداء للضبط <code>error</code> وتستدعى إن فشل الطلب. تقبل أن يمرَّر إليها الكائن jqXHR، وسلسلة نصية تشير إلى نوع الخطأ، وكائن استثنائي إن أمكن. ستوفِّر بعض الأخطاء المضمَّنة سلسلة نصية تمثل كائنًا استثنائيًّا مثل "abort" أو "timeout" أو "No Transport".
# دالة رد النداء للضبط <code>dataFilter</code> وتستدعى عند نجاح استلام بيانات الرد. تقبل أن يمرَّر إليها البيانات المعادة وقيمة <code>dataType</code> ويجب أن يعيد البيانات (المحتمل أنها تغيرت) لتمريرها إلى <code>success</code>.
# دالة رد النداء للضبط <code>success</code> وتستدعى إن نجح الطلب. تقبل أن يمرَّر إليها البيانات المعادة، وسلسلة نصية تحتوي على رمز نجاح العمليَّة، والكائن jqXHR.
# دوال ردود النداء <code>Promise</code> وهي: ‎<code>.done()‎</code>، و ‎<code>.fail()</code>‎، و ‎.always()<code>‎،</code> و <code>‎.then()‎</code> وتستدعى وفقًا للترتيب الذي سجلت فيه.
# دالة رد النداء للضبط <code>complete</code> وتستدعى عند انتهاء الطلب سواءً كان هذا الطلب ناجحًا أم فاشلًا. تقبل أن يمرَّر إليها الكائن jqXHR بالإضافة إلى سلسلة نصية تحتوي على رمز نجاح أو فشل الطلب.

=== أنواع البيانات ===
تتعلق أنواع الردود المختلفة لاستدعاء الدالة ‎<code>$.ajax()</code>‎ بمختلف أنواع العمليات التي أجريت مسبقًا قبل أن تمرَّر إلى معالج الحدث <code>success</code>. يعتمد نوع تلك العمليات افتراضيًّا على نوع محتوى الرد ولكن يمكن ضبط ذلك صراحةً باستعمال الضبط <code>dataType</code>. إن أعطيت قيمة الضبط <code>dataType</code>، فستُهمَل ترويسة نوع المحتوى (Content-Type header) للرد.

أنواع البيانات المتاحة هي: text، و html، و xml، و json، و jsonp، و script.

إن حُدِّد النوع text أو html، فلن تحدث أية عمليات معالجة مسبقة. تمرَّر البيانات ببساطة إلى المعالج <code>success</code>، ثمَّ تصبح متاحةً بعدئذٍ عبر الخاصِّيَّة <code>responseText</code> للكائن jqXHR.

إن حُدِّد النوع xml، فسيحلَّل الرد باستعمال <code>[[jQuery/jQuery/parseXML|jQuery.parseXML]]</code> قبل أن يمرَّر ككائن مستند XMLDocument إلى معالج الحدث <code>success</code>. يصبح المستند XML متاحًا عبر الخاصِّيَّة <code>responseXML</code> للكائن jqXHR.

إن حُدِّد النوع json فسيحلَّل الرد باستعمال <code>[[jQuery/jQuery/parseJSON|jQuery.parseJSON]]</code> قبل أن يمرر ككائن إلى معالج الحدث <code>success</code>. يصبح الكائن JSON متاحًا عبر الخاصِّيَّة <code>responseJSON</code> للكائن jqXHR.

إن حُدِّد النوع script، فستنفِّذ الدالة ‎<code>$.ajax()‎</code> السكربت الذي تستلمه من الخادم قبل أن تمرِّره إلى معالج الحدث <code>success</code> كسلسلة نصية.

أما إن حُدِّد النوع jsonp، فستضيف <code>‎$.ajax()</code>‎ تلقائيًّا للمعامل سلسلة الاستعلام النصية <code>callback=?</code>‎ (الافتراضي) إلى العنوان URL. يمكن استعمال الخاصِّيَّة <code>jsonp</code> والخاصِّيَّة <code>jsonpCallback</code> للإعدادات <code>settings</code> الممررة إلى ‎<code>$.ajax()</code>‎ لتحديد اسم معامل سلسلة الاستعلام النصية واسم دالة رد النداء <code>JSONP</code> على التوالي. يجب أن يعيد الخادم سكربتًا صحيحًا يمرر الرد <code>JSON</code> إلى دالة رد النداء. ستنفِّذ الدالة ‎<code>$.ajax()</code>‎ ذلك السكربت المعاد باستدعاء دالة رد النداء <code>JSONP</code> قبل تمرير الكائن JSON الذي يحتوي على الرد إلى معالج الحدث <code>success</code> للدالة ‎<code>$.ajax()</code>‎.

للمزيد من المعلومات حول JSONP، يمكنك الرجوع إلى [https://bob.pythonmac.org/archives/2005/12/05/remote-json-jsonp/ هذا المقال].

=== إرسال البيانات إلى الخادم ===
ترسل طلبات Ajax افتراضيًّا عبر HTTP باستعمال طريقة GET. إن دعت الحاجة إلى استعمال طريقة POST، فيمكن تغيير الطريقة المستعملة بضبط قيمة الوسيط <code>type</code> في الإعدادات <code>settings</code> إلى هذه الطريقة، إذ يحدِّد هذا الوسيط كيفية إرسال محتوى الوسيط <code>data</code> إلى الخادم. سينقل المحتوى إلى الخادم عند تحديد الطريقة POST باستعمال الترميز UTF-8، إذ ذلك ما نص عليه المعيار W3C XMLHTTPRequest.

يمكن أن يحوي الضبط <code>data</code> إمَّا سلسلة استعلام نصية من النموذج <code>key1=value1&key2=value2</code>، أو كائنًا من النموذج <code>{key1: 'value1', key2: 'value2'‎}</code>. إن استُعمل النموذج الأخير، فستُحول البيانات إلى سلسلة استعلام نصية باستعمال <code>[[jQuery/jQuery/param|jQuery.param()‎]]</code> قبل أن تُرسل. يمكن التحايل على هذه العملية بتغيير قيمة الضبط <code>processData</code> إلى <code>false</code>، إذ قد تكون هذه العملية غير مرغوب فيها خصوصًا إن أردت إرسال كائن XML إلى الخادم. في هذه الحالة، غيِّر قيمة الضبط <code>contentType</code> من النوع <code>application/x-www-form-urlencoded</code> إلى نوع MIME أكثر ملائمةً.

=== خيارات متقدمة ===
يمنع الضبط <code>global</code> معالجات الأحداث المسجلة باستعمال التابع <code>[[jQuery/ajaxSend|‎.ajaxSend()‎]]</code>، والتابع ‎<code>[[jQuery/ajaxError|.ajaxError()‎]]</code>، وتوابع أخرى مشابهة من أن تُطلق عندما يستدعيها الطلب. يمكن أن يكون هذا مفيدًا لإخفاء مؤشر التحميل مثلًا الذي نُفِّذ مع <code>[[jQuery/ajaxSend|‎.ajaxSend()‎]]</code> إن كانت الطلبات متكررة وموجزة. تتغير قيمة الضبط <code>global</code> إلى <code>false</code> تلقائيًّا مع السكربت العابر للنطاق (cross-domain script) والطلبات JSONP. انظر إلى شرح هذه التوابع في الأسفل للمزيد من التفاصيل.

إن أراد الخادم أن يجري مصادقةً قبل أن يرسل ردًا، فيمكن حينذاك إرسال اسم المستخدم وكلمة المرور بوساطة الضبط <code>username</code> والضبط <code>password</code>.

إن طلبات Ajax محدودةٌ بزمنٍ، لذا يمكن التعرف على الأخطاء ومعالجتها لتحسين تجربة المستخدم (user experience). قيمة المهلة الزمنية للطلب هي غالبًا إمَّا القيمة الافتراضيَّة الأساسية أو القيمة المعيَّنة كقيمة افتراضيَّة باستعمال <code>[[jQuery/jQuery/ajaxSetup|‎$.ajaxSetup()‎]]</code>، فقد تحتاج أحيانًا إلى تجاهل هاتين القيمتين لطلبات محددة باستعمال الضبط <code>timeout</code>.

يرسل الطلب دومًا افتراضيًّا ولكن المتصفح قد يخزِّن النتيجة المرتبطة به. إن أردت منع تخزين نتيجة الطلبات، فغيِّر قيمة الضبط <code>cache</code> إلى <code>false</code>. أمَّا إن أردت أن يُبلِّغ الطلب عن حالة الفشل عندما لا يتغير فحوى الرد عن الطلب السابق، فغيِّر قيمة الضبط <code>ifModified</code> إلى <code>true</code>.

يساعد الضبط <code>scriptCharset</code> بتحديد ترميز المحارف للطلبات التي تستعمل الوسم <code>[[HTML/script|<script>]]</code> ضمنها (مثل الطلبات ذات النوع script والنوع jsonp). هذا الضبط مفيدُ جدًا في حال اختلاف الترميز المستعمل في السكربت عن نظيره المستعمل في الصفحة المستضيفة.

ذُكر في بداية هذا التوثيق، في قسم الوصف تحديدًا، أنَّ هذه الدالة ترسل طلبًا بشكل غير متزامن، إذ تشير العبارة "غير متزامن" إلى أنَّ عمليَّة الإرسال تحدث على التوازي وليس هنالك أي ضمان لإكمال تنفيذ العملية وفقًا لترتيب ما. القيمة الافتراضيَّة للضبط <code>async</code> هي <code>true</code> وهذا يعني أن تنفيذ الشيفرة قد يستمر بعد اكتمال إرسال الطلب. ينصح بشدة عدم تعيين قيمة هذا الضبط إلى <code>false</code>، إذ تصبح حينئذٍ العملية متزامنة ويمكن أن تؤدي إلى خروج المتصفح عن الاستجابة.

تنشئ الدالة <code>‎$.ajax()</code>‎ الكائن XMLHttpRequest ثمَّ تعيده. تسهم jQuery في عملية معالجة وإنشاء هذا الكائن داخليًا وبشكل طبيعي ولكن يمكن أيضًا تحديد دالة مخصَّصة لإنشاء هذا الكائن باستعمال الضبط xhr. يمكن التخلص هذا الكائن المعاد بسهولة إلا أنَّه يوفر واجهة منخفضة المستوى (lower-level interface) لمراقبة وتعديل الطلب. سيؤدي استدعاء التابع ‎<code>.abort()‎</code> بالتحديد مع الكائن XMLHttpRequest إلى مقاطعة الطلب وإلغائه قبل أن يكتمل.

=== Ajax الموسّعة ===
بدءًا من الإصدار jQuery 1.5، أصبح تنفيذ Ajax في jQuery يتضمن [[jQuery/jQuery/ajaxPrefilter|المرشحات المسبقة]] (prefilters) [[jQuery/jQuery/ajaxTransport|والنواقل]] (transports)، والمحولات (converters) التي توسِّع Ajax بتوفير قدر كبير من المرونة.

=== استعمال المحولات ===
تدعم المحولات في ‎<code>$.ajax()</code>‎ تعيين (mapping) أنواع بيانات إلى أنواع بيانات أخرى. إن أردت تعيين نوع بيانات مخصَّص إلى نوع معروف (مثل json)، فيجب أن تضيف رابطًا يوافق بين نوع محتوى الرد ونوع البيانات الفعلي باستعمال الضبط <code>contents</code>:<syntaxhighlight lang="javascript">
$.ajaxSetup({
  contents: {
    mycustomtype: /mycustomtype/
  },
  converters: {
    "mycustomtype json": function( result ) {
      // افعل شيئًا هنا
      return newresult;
    }
  }
});

</syntaxhighlight>هذا الكائن الإضافي ضروري جدًا لأنَّ نوع محتوى الرد وأنواع البيانات لا تتطابق مطلقًا (وبالتالي يُعتمد على التعابير النمطية).

للتحويل من نوع مدعوم (مثل text أو json) إلى نوع بيانات مخصَّص والتحويل بالعكس أيضًا، استعمل المحولات الممرَّرة (pass-through converter) الأخرى:<syntaxhighlight lang="javascript">
$.ajaxSetup({
  contents: {
    mycustomtype: /mycustomtype/
  },
  converters: {
    "text mycustomtype": true,
    "mycustomtype json": function( result ) {
      // افعل شيئًا هنا
      return newresult;
    }
  }
});
</syntaxhighlight>تسمح لنا هذه الشيفرة بالتحويل من text إلى mycustomtype ثمَّ من mycustomtype إلى json.

=== ملاحظات إضافية ===
* بسبب القيود الأمنية للمتصفحات، فإنَّ أغلب طلبات "Ajax" تخضع إلى سياسة المصدر الواحد (Same origin policy). لن يتمكن الطلب آنذاك من جلب البيانات بنجاح من نطاقات أو نطاقات فرعية أو منافذ أو بروتوكولات مختلفة.
* لا يخضع الطلب script والطلب JSONP إلى قيود سياسة المصدر الواحد.

=== أمثلة ===
حفظ بعض البيانات في الخادم وإبلاغ المستخدم عند الانتهاء من العمليَّة:<syntaxhighlight lang="javascript">
$.ajax({
  method: "POST",
  url: "some.php",
  data: { name: "محمد", location: "سوريا" }
})
  .done(function( msg ) {
    alert( "حُفظت البيانات: " + msg );
  });

</syntaxhighlight>إستعادة أحدث إصدار من صفحة HTML:<syntaxhighlight lang="javascript">
$.ajax({
  url: "test.html",
  cache: false
})
  .done(function( html ) {
    $( "#results" ).append( html );
  });
</syntaxhighlight>إرسال مستند xml كبيانات إلى الخادم. سيؤدي تعيين قيمة الضبط <code>processData</code> إلى <code>false</code> إلى منع تحويل البيانات إلى سلسلة نصية تلقائيًّا:<syntaxhighlight lang="javascript">
var xmlDocument = [create xml document];
var xmlRequest = $.ajax({
  url: "page.php",
  processData: false,
  data: xmlDocument
});
 
xmlRequest.done( handleResponse );
</syntaxhighlight>إرسال قيمة الخاصِّيَّة <code>id</code> كبيانات إلى الخادم لحفظها، وإبلاغ المستخدم حال اكتمال أو فشل العملية:<syntaxhighlight lang="javascript">
var menuId = $( "ul.nav" ).first().attr( "id" );
var request = $.ajax({
  url: "script.php",
  method: "POST",
  data: { id : menuId },
  dataType: "html"
});
 
request.done(function( msg ) {
  $( "#log" ).html( msg );
});
 
request.fail(function( jqXHR, textStatus ) {
  alert( "فشل الطلب: " + textStatus );
</syntaxhighlight>تحميل ملف JavaScript وتنفيذه:<syntaxhighlight lang="javascript">
$.ajax({
  method: "GET",
  url: "test.js",
  dataType: "script"
});

</syntaxhighlight>

== مصادر ==
* [http://api.jquery.com/jQuery.ajax/ صفحة الدالة ‎ajax في توثيق jQuery الرسمي.]
[[تصنيف:jQuery]]
[[تصنيف:jQuery Ajax]]