English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

طريقة jQuery ajaxSetup()

طريقة AJAX لـ jQuery

يُستخدم طريقة $ .ajaxSetup() لضبط القيم الافتراضية للطلبات Ajax المستقبلية.

إلا إذا تم تغطية كل منهم في الطلبات اللاحقة، فإن جميع الطلبات اللاحقة التي تستخدم أي طريقة يتم تنفيذها باستخدام القيم الجديدة حتى تُتاح دعوة أخرى لـ $ .ajaxSetup().

النحو:

$.ajaxSetup({name:value, name:value, ...})

مثال

تعيين URL افتراضية لجميع طلبات AJAX:

$.ajaxSetup({
  url: "ajax_post.php"
});
//سيتم استخدام URL "ajax_post.php" تلقائيًا في كل مرة يتم إرسال طلب Ajax:
$.ajax({
  data: {fname:"Seagull", lname:"Anna"},
  method: "POST",
  success: function(response){
    $("div").html(response);
  }
});
الاختبار لمعرفة إذا كان‹/›

تعيين URL افتراضية والوظيفة الناجحة لجميع طلبات AJAX:

$.ajaxSetup({
  url: "ajax_data.txt",
  success: function(response){
    $("div").html(response);
  }
});
$("button").click(function(){
  $.ajax();
});
الاختبار لمعرفة إذا كان‹/›

إذا واجهت طلب Ajax خطأ، يتم عرض إشعار:

$.ajaxSetup({
  url: "wrong_file.html",
  success: function(response){
    $("div").html(response);
  },
  error: function(xhr){
    الخطأ: $("div").html("خطأ: " + xhr.status + " " + xhr.statusText);
  }
});
$("button").click(function(){
  $.ajax();
});
الاختبار لمعرفة إذا كان‹/›

ملاحظة:الاشارة إلى) المحددة هنا ستؤثر على$ .ajaxالأنواع المشتقة من Ajax (مثلطريقة $ .get() أوجميع الطلبات. حيث قد يتوقع المُستخدمون الآخرون (مثل الأدوات المدمجة) استخدام الإعدادات الافتراضية العادية، مما قد يؤدي إلى سلوك سيء. لذلك،يُنصح بعدم استخدام طريقة $ .ajaxSetup().

. وليس بالضرورة أن يتم تعيين الخيارات بشكل واضح في الطلب أو تعريف أداة بسيطة.

يُستخدم اسم المعامل باستخدام اسم:قيمة لتحديد إعدادات الطلب AJAX.

أسماء محتملة: القيم المذكورة في الجدول أدناه:

الاسمنوع القيمةالوصف
asyncالنوع البوليقيمة بولية تشير إلى ما إذا كان يجب معالجة الطلب بشكل غير متزامن. القيمة الافتراضية هي true
beforeSend(xhr)دالةالوظيفة التي يتم تشغيلها قبل إرسال الطلب.
cacheالنوع البوليقيمة بولية تشير إلى ما إذا كان يجب على المتصفح حفظ صفحة الطلب. القيمة الافتراضية هي true
complete(xhr,status)دالةالوظيفة التي يتم تشغيلها عند اكتمال الطلب (بعد الوظائف الناجحة والمعطوبة).
contentTypeقيمة بولية أو نصنوع المحتوى الذي يتم استخدامه عند إرسال البيانات إلى الخادم. القيمة الافتراضية هي: 'application / x-www-form-urlencoded'
contextعنصر عاديتحديد قيمة 'this' للوظائف الدالة المرتبطة بأيكس جيكس.
dataPlainObject أو String أو Arrayتحديد البيانات التي سيتم إرسالها إلى الخادم.
dataFilter(data,type)دالةالوظيفة التي يتم استخدامها لمعالجة البيانات الجذرية لـ XMLHttpRequest.
dataTypeالنصنوع البيانات التي يتم توقعها من استجابة الخادم.
error(xhr,status,error)دالةالوظيفة التي يتم تشغيلها عند فشل الطلب
globalالنوع البوليقيمة بولية تحدد ما إذا كان يجب إطلاق معالج الحدث AJAX العالمي. القيمة الافتراضية هي true
ifModifiedالنوع البوليقيمة بولية تحدد ما إذا كان يجب أن تكون الطلب ناجحًا فقط عندما يتم تغيير الرد على الطلب منذ آخر مرة. القيمة الافتراضية هي: false.
jsonpنص أو بوليةتغطية وظيفة اللفظ المدمج في طلب jsonp.
jsonpCallbackدالةتحديد اسم الوظيفة التي يتم استدعاؤها في طلب jsonp.
methodالنصتحديد طريقة HTTP التي يتم استخدامها في الطلب. (الإلتقاط أو الإضافة). القيمة الافتراضية هي GET
passwordالنصتحديد كلمة المرور التي يتم استخدامها في طلب التحقق من صحة HTTP.
processDataالنوع البوليقيمة بولية، تحدد ما إذا كان يجب تحويل البيانات التي يتم إرسالها مع الطلب إلى سلسلة استعلام. القيمة الافتراضية هي true
scriptCharsetالنصتحديد مجموعة الحروف للطلب
statusCodeعنصر عاديعنصر عادي يحتوي على عدد من الأرقام HTTP وكائنات الوظائف التي سيتم استدعاؤها عند وجود استجابة بهذه الأرقام
$.ajax({
  statusCode: {
    404: function() {
      alert(“لا يمكن العثور على الصفحة”)
    }
  }
})
success(response,status,xhr)دالةالوظيفة التي سيتم تشغيلها عند نجاح الطلب
timeoutرقمالوقت المحدد للتحقق المحلي (بالميليسي ثانية)
traditionalالنوع البوليقيمة بولية، تحدد ما إذا كان سيتم استخدام نمط سلسلة المعلمات التقليدية
typeالنصmethodاسم المستخدم. إذا كنت تستخدم إصدار jQuery 1.9.0 أو أقدم، يجب عليك استخدام type
urlالنصتحديد URL التي سيتم إرسال الطلب إليها. إذا لم يتم تحديد أي شيء، سيكون الطلب إلى الصفحة الحالية
usernameالنصتحديد اسم المستخدم الذي سيتم استخدامه في طلب التحقق من هوية HTTP
xhrدالةدالة لإنشاء عنصر XMLHttpRequest

طريقة AJAX لـ jQuery