Урок - jQuery.ajaxSetup()

Группа вКонтакте
Лицензия: Лицензия Creative Commons.

Метод jQuery.ajaxSetup() позволяет установить параметры по умолчанию для всех будущих запросов Ajax.

Синтаксис метода jQuery.ajaxSetup()

jQuery.ajaxSetup(options)

где

  • options - параметры, в виде ключ-значение, по умолчанию для AJAX-запросов.

Более подробную информацию об jQuery.ajaxSetup() можно почерпнуть в jQuery.ajax().

Все последующие AJAX-запросы, с помощью любых методов, будут использовать указанные настройки, если не заменены отдельно для конкретного AJAX-запроса, или до следующего вызова jQuery.ajaxSetup().

Примечание:

Настройки, указанные в jQuery.ajaxSetup() будут влиять на все вызовы jQuery.ajax() и AJAX-базовые запросы, такие как jQuery.get(). Однако это может привести к нежелательному поведению, например другие разработчики (например, разработчики плагинов) ожидают стандартные значения по умолчанию. По этой причине мы настоятельно рекомендуем НЕ ИСПОЛЬЗОВАТЬ метод jQuery.ajaxSetup(). Вместо этого устанавливайте параметры в явном виде на AJAX-запрос или определите простой плагин для этого.

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

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

Теперь все AJAX-запросы будут отправляться по урлу 'ping.php':

$.ajax({
    // параметр url здесь не задан; используем ping.php
    data: {'name': 'Dan'}
});

Примечание:

Глобальные функции обратного вызова должны быть установлены в обработчиках ajaxStart(), ajax Stop(), ajaxcomplete(), ajaxError(), ajaxSend() - а не внутрие метода jQuery.ajaxSetup().

Пример:

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

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