Spec-Zone.ru › jQuery

jQuery.ajaxSetup()

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

Описание: Устанавливает значения по умолчанию для будущих Ajax-запросов. Его использование не рекомендуется.

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

    • options
      Тип: PlainObject
      Набор пар «ключ-значение», которые конфигурируют стандартный Ajax-запрос. Все параметры необязательны.

Подробнее о параметрах, доступных для $.ajaxSetup(), см. $.ajax().

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

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

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

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

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

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

Примечание: Глобальные обработчики событий должны быть настроены с помощью .on() с соответствующими глобальными событиями 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 });

© The jQuery Foundation and other contributors
Licensed under the MIT License.
https://api.jquery.com/jQuery.ajaxSetup

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API