jQuery 3.3

jQuery.ajaxSetup()




jquery

jQuery.ajaxSetup (خيارات) إرجاع: PlainObject

الوصف: قم بتعيين القيم الافتراضية لطلبات Ajax المستقبلية. لا ينصح استخدامه.

  • الإصدار المضاف: 1.1 jQuery.ajaxSetup (خيارات)

    • خيارات
      اكتب: PlainObject
      مجموعة من أزواج المفاتيح / القيم التي تقوم بتهيئة طلب Ajax الافتراضي. جميع الخيارات اختيارية.

للحصول على تفاصيل حول الإعدادات المتوفرة $.ajaxSetup() ، راجع $.ajax() .

ستستخدم جميع مكالمات Ajax اللاحقة التي تستخدم أي وظيفة الإعدادات الجديدة ، ما لم يتم تجاوزها بواسطة المكالمات الفردية ، حتى الاستدعاء التالي $.ajaxSetup() .

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

على سبيل المثال ، يقوم الإعداد التالي بتعيين افتراضي لمعلمة url قبل تنفيذ الأمر ping على الخادم بشكل متكرر:

$.ajaxSetup({
  url: "ping.php"
});

الآن في كل مرة يتم فيها تقديم طلب Ajax ، سيتم استخدام عنوان URL "ping.php" تلقائيًا:

$.ajax({
  // url not set here; uses ping.php
  data: { "name": "Dan" }
});

ملاحظة: يجب تعيين وظائف رد الاتصال العالمي مع .ajaxStart() معالج الأحداث الخاصة بها في Ajax على المستوى العالمي .ajaxStart() و .ajaxStop() و .ajaxComplete() و .ajaxError() و .ajaxSuccess() و .ajaxSend() بدلاً من كائن options لـ $.ajaxSetup() .

مثال:

يعيّن الإعدادات الافتراضية لطلبات Ajax إلى عنوان URL "/ xmlhttp /" ، ويعطل المعاملات العمومية ويستخدم POST بدلاً من GET. ثم ترسل طلبات Ajax التالية بعض البيانات دون الحاجة إلى تعيين أي شيء آخر.

$.ajaxSetup({
  url: "/xmlhttp/",
  global: false,
  type: "POST"
});
$.ajax({ data: myData });