jQuery.ajaxSetup()


jQuery.ajaxSetup( options )Возвращает: void

Описание: Устанавливает значения по умолчания для Ajax запросов. Не рекомендуется использовать.

  • Добавлен в версии: 1.1jQuery.ajaxSetup( options )

    • options
      Тип: PlainObject
      Ассоциативный массив с парами параметров значений по умолчанию Ajax запроса. Все параметры не обязательны к указанию.

Все доступные параметры метода $.ajaxSetup(), смотрите в описании метода $.ajax().

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

Важно: Настройки указанные в этом методе будут влиять на все вызовы $.ajax или Ajax-производные запросы, такие как $.get(). Это может вызвать неожиданное поведение, т.к. другие вызывающие (например плагины) будут ожидать обычных настроек по умолчанию. По этой причине мы строго рекомендуем не использовать данные метод API. Предпочитетельнее, явно указать параметры при вызове Ajax метода или сделать простой плагин, который будет делать это.

Например, следующий код устанавливает параметр url по умолчанию:

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

Теперь каждый совершенный вызов Ajax запроса, будет использовать URL-адрес "ping.php" автоматически:

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

Важно: Глобальные функции обратного вызова должны быть установлены при помощи методов для установки глобальных Ajax событий — .ajaxStart(), .ajaxStop(), .ajaxComplete(), .ajaxError(), .ajaxSuccess(), .ajaxSend() — а не при помощи объекта options в методе $.ajaxSetup().

Пример:

Устанавливает значениея по умолания для Ajax запросов для url "/xmlhttp/", отключает глобальные обработчики и использует POST вместо GET. Следующий за этим вызов Ajax запрос отправляет какие то данные без необходимости указания других параметров.

1
2
3
4
5
6
$.ajaxSetup({
url: "/xmlhttp/",
global: false,
type: "POST"
});
$.ajax({ data: myData });