متد jQuery.ajaxSetup( options ) در jQuery
دسته بندی : آموزش jQuery سطح مقاله : متوسط زمان مطالعه : 5 دقیقه آخرین بروز رسانی: 17 خرداد 1401متد jQuery.ajaxSetup( options ) در jQuery در این مقاله از سری مقالات آموزش جی کوئری دویکس بررسی می‌شود. روش jQuery.ajaxSetup( options ) تنظیمات کلی را برای درخواست‌های AJAX آینده تنظیم می‌کند.
ساختار متد
در اینجا نحو و ساختار ساده برای استفاده از این متد آمده است:
$.ajaxSetup( options )پارامترهای متد jQuery.ajaxSetup( options ) در jQuery
در اینجا تمام پارامترهای استفاده شده توسط این متد توضیح داده شده است:
- options : مجموعه‌ای از جفت‌های کلید/مقدار که درخواست Ajax را پیکربندی می‌کند، همه گزینه‌ها اختیاری هستند.
| شماره | گزینه و توضیحات |
| 1 | async یک Boolean که نشان می‌دهد آیا درخواست به صورت ناهمزمان انجام شود یا خیر، مقدار پیش فرض true است. |
| 2 | beforeSend یک تابع فراخوانی که قبل از ارسال درخواست اجرا می‌شود. |
| 3 | complete یک تابع فراخوانی که هر زمان که درخواست به پایان برسد اجرا می‌شود. |
| 4 | contentType رشته‌ای حاوی یک نوع محتوای MIME برای تنظیم درخواست، مقدار پیش فرض application/x-www-form-urlencoded است. |
| 5 | data نقشه یا رشته‌ای که به همراه درخواست به سرور ارسال می‌شود. |
| 6 | dataFilter تابعی که برای رسیدگی به داده‌های پاسخ داده شده خام XMLHttpRequest استفاده می‌شود. |
| 7 | dataType رشته‌ای که نوع داده‌های مورد انتظار از سرور را تعریف می‌کند (xml، html، json، یا اسکریپت). |
| 8 | error یک تابع فراخوانی که در صورت عدم موفقیت درخواست اجرا می‌شود. |
| 9 | global یک Boolean که نشان می‌دهد که آیا کنترل‌کننده‌های رویداد سراسری AJAX توسط این درخواست فعال می‌شوند یا خیر، مقدار پیش فرض true است. |
| 10 | ifModified یک Boolean که نشان می‌دهد که آیا سرور باید قبل از پاسخ دادن به درخواست بررسی کند که آیا صفحه اصلاح شده است یا خیر. |
| 11 | jsonp در یک درخواست jsonp نام تابع callback را لغو می‌کند. |
| 12 | password رمز عبوری که در پاسخ به درخواست احراز هویت دسترسی HTTP استفاده می‌شود. |
| 13 | processData یک Boolean که نشان می‌دهد که آیا باید داده‌های ارسال شده از یک فرم شی به یک فرم query-string تبدیل شوند یا خیر؛ مقدار پیش فرض true است. |
| 14 | success یک تابع فراخوانی که در صورت موفقیت درخواست اجرا می‌شود. |
| 15 | timeout تعداد میلی‌ثانیه‌هایی که پس از آن درخواست با شکست مواجه می‌شود. |
| 16 | timeout یک مهلت زمانی محلی (بر حسب میلی ثانیه) برای درخواست تنظیم می‌کند. |
| 17 | type رشته‌ای که روش HTTP را برای استفاده برای درخواست تعریف می‌کند (GET یا POST)؛ مقدار پیش فرض GET است. |
| 18 | url رشته‌ای حاوی URL که درخواست به آن ارسال می‌شود. |
| 19 | username نام کاربری که در پاسخ به درخواست احراز هویت دسترسی HTTP استفاده می‌شود. |
| 20 | xhr Callback برای ایجاد شی XMLHttpRequest؛ پیش‌فرض ActiveXObject در صورت موجود بودن (IE) و XMLHttpRequest در غیر این صورت. |
مثال
با فرض اینکه در فایل result.html محتوای HTML زیر را داریم:
<h1>THIS IS RESULT...</h1>در قطعه کد زیر با یک مثال ساده نشان داده شده است که استفاده از این متد چگونه است. در اینجا ما از کنترل کننده success برای پر کردن HTML بازگشتی استفاده می‌کنیم:
<html>
<head>
<title>The jQuery Example</title>
<script type = "text/javascript"
src = "https://www.tutorialspoint.com/jquery/jquery-3.6.0.js">
</script>
<script type = "text/javascript" language = "javascript">
$(document).ready(function() {
$("#driver").click(function(event){
// Do global setting.
$.ajaxSetup({
url: "result.html"
});
$.ajax( {
success:function(data) {
$('#stage').html(data);
}
});
});
});
</script>
</head>
<body>
<p>Click on the button to load result.html file:</p>
<div id = "stage" style = "background-color:#cc0;">
STAGE
</div>
<input type = "button" id = "driver" value = "Load Data" />
</body>
</html>مطالعه مقاله بررسی Ajax در jQuery به شما پیشنهاد می‌شود؛ مقاله متد jQuery.ajaxSetup( options ) در jQuery در اینجا به پایان می‌رسد، نظرات خود را با ما به اشتراک بگذارید.
این مقاله چقدر براتون مفید بود؟