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

Метод jQuery ajaxSetup()

Методы AJAX jQuery

Метод $ .ajaxSetup() устанавливает default значения для будущих Ajax-запросов.

Если не будет overwritten в отдельных вызовах, все последующие Ajax-вызовы, выполненные с помощью любого метода, будут использовать новые настройки до следующего вызова $ .ajaxSetup().

Грамматика:

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

Пример

Установить default URL для всех AJAX-запросов:

$.ajaxSetup({
  url: "ajax_post.php"
});
//Теперь каждый раз при отправке запроса Ajax будет автоматически использовать URL "ajax_post.php":
$.ajax({
  data: {fname:"Seagull", lname:"Anna"},
  method: "POST",
  success: function(response){
    $("div").html(response);
  }
});
Проверьте < / >

Установить default 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() или на основе Ajax производных классов (например,Все вызовы. Поскольку другие вызовщики (например, плагины) могут ожидать использования обычных параметров по умолчанию, это может привести к不良шему поведению. Поэтому,Категорически рекомендуется не использовать метод $.ajaxSetup()

. Вместо этого установите параметры явно в вызове или определите простой плагин.

Параметры используются для указания настроек AJAX запроса с помощью одного или нескольких пар name:value

Возможные названия: значения в таблице ниже:

НазваниеТип значенияОписание
asyncБулевоБулево значение, указывающее, следует ли обрабатывать запрос асинхронно. Значение по умолчанию: true
beforeSend(xhr)ФункцияФункция, выполняемая перед отправкой запроса
cacheБулевоБулево значение, указывающее, следует ли браузеру кэшировать запрашиваемую страницу. Значение по умолчанию: true
complete(xhr,status)ФункцияФункция, выполняемая после завершения запроса (после успешного и ошибочного выполнения)
contentTypeБулево значение или строкаТип содержимого, используемый при отправке данных на сервер. Значение по умолчанию: "application / x-www-form-urlencoded"
contextОбычный объектУказывает значение "this" для всех回调 функций, связанных с AJAX
dataPlainObject или String или ArrayУказывает данные, которые нужно отправить на сервер
dataFilter(data,type)ФункцияФункция, используемая для обработки исходных данных ответа XMLHttpRequest
dataTypeСтрокаТип данных, ожидаемый в ответе сервера
error(xhr,status,error)ФункцияФункция, выполняемая при失败 запроса
globalБулевоБулево значение, определяющее, следует ли вызывать глобальный обработчик события AJAX для запроса. По умолчанию установлено в true
ifModifiedБулевоБулево значение, определяющее, следует ли считать запрос успешным только в том случае, если ответ с последнего запроса изменен. Значение по умолчанию: false.
jsonpСтрока или булевоПерекрывает callback функцию 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