JavaScript. Подробное руководство, 6-е издание
вернуться

Флэнаган Дэвид
Шрифт:

"script"

Предполагает, что URL-адрес ссылается на файл со сценарием на языке JavaScript, и перед передачей функции обратного вызова текст ответа выполняется как сценарий. Этот тип используется функцией

jQuery.getScript.
Когда указывается тип "script", библиотека будет выполнять междоменные запросы с помощью элемента
<script>
вместо объекта
XMLHttpRequest
.

"json"

Предполагает, что URL-адрес ссылается на файл с данными в формате JSON. Функции обратного вызова в этом случае передается объект, полученный в результате разбора содержимого ответа с помощью функции

jQuery.parseJSON
(раздел 19.7). Этот тип используется функцией
jQuery.getJS0N.
Если указан тип "json" и строка URL или данных содержит "=?", тип преобразуется в "jsonp".

"jsonp"

Предполагает, что URL-адрес ссылается на серверный сценарий, поддерживающий протокол JSONP передачи данных в формате JSON в виде аргумента указанной функции на стороне клиента. (Подробнее о формате JSONP рассказывается в разделе 18.2.) Когда указывается этот тип, функции обратного вызова передается разобранный объект. Поскольку JSONP-запросы могут выполняться с помощью элементов

<script>,
этот тип можно использовать для выполнения междоменных запросов, подобно типу "script”. При использовании этого типа строка URL или данных обычно должна включать параметр вида
"&jsonp=
?" или
"&callback=?".
Библиотека jQuery заменит знак вопроса именем автоматически созданной функции обратного вызова. (Обратите внимание на параметры
jsonp
и
jsonpCallback
, описываемые в разделе 19.6.3.3, позволяющие определить альтернативные варианты.)

Если при вызове

jQuery.get, jQuery.post
или
jQuery.ajax
не указан ни один из этих типов, библиотека jQuery проверит заголовок «Content-Type» HTTP-ответа. Если этот заголовок включает подстроку «xml», функции обратного вызова будет передан XML-документ. Иначе, если заголовок включает подстроку «json», ответ будет разобран, как данные в формате JSON, и полученный объект будет передан функции обратного вызова. Иначе, если заголовок включает подстроку «JavaScript», ответ будет выполнен как сценарий. Иначе данные будут интерпретироваться как простой текст.

19.6.3. Функция jQuery.ajax

Все утилиты поддержки архитектуры Ajax в библиотеке jQuery в конечном итоге вызывают

jQuery.ajax
– самую сложную функцию во всей библиотеке. Функция
jQuery. ajax
принимает всего один аргумент: объект с параметрами, свойства которого определяют детали, касающиеся выполнения Ajax-запроса. Вызов
jQuery.getScript(url,callback),
например, эквивалентен следующему вызову функции
jQuery.ajax:

jQuery.ajax({

type: "GET”,

// Метод НТТР-запроса.

url: url, // URL-адрес запрашиваемых данных.

data: null, // Не добавлять дополнительные данные в URL.

dataType: "script" // Выполнить ответ как сценарий.

success: callback // Вызвать эту функцию по завершении.

});

Эти пять фундаментальных параметров можно также установить при использовании функций

jQuery.get
и
jQuery.post
. Однако при непосредственном использовании
jQuery.ajax
имеется возможность указать большое количество других параметров. Все параметры (включая пять основных, представленных выше) детально описываются ниже.

Прежде чем погрузиться в описание параметров, обратите внимание, что имеется возможность определить значения по умолчанию любых из этих параметров, передав объект с параметрами функции

jQuery. ajaxSetup
:

jQuery.ajaxSetup({

timeout: 2000, // Прерывать все Ajax-запросы через 2 секунды

cache: false // Игнорировать кэш броузера, добавляя время в URL

}):

После выполнения программного кода, приведенного выше, указанные параметры timeout и cache будут действовать для всех Ajax-запросов (включая высокоуровневые утилиты, такие как

jQuery.get
и
load
), при вызове которых не указываются значения этих параметров.