Книга: JavaScript. Подробное руководство, 6-е издание
19.6.2.3. jQuery.get() и jQuery.post()
19.6.2.3. jQuery.get() и jQuery.post()
Функции jQuery.get() и jQuery.post() загружают содержимое из указанного адреса URL, отправляя дополнительные данные, если они имеются, и передавая результат указанной функции обратного вызова. Функция jQuery.get() делает это, выполняя HTTP-запрос методом GET, а функция jQuery.post() - методом POST, но во всем остальном эти две вспомогательные функции совершенно идентичны. Обе они принимают те же три аргумента, что и функция jQuery.getJSON(): обязательный URL-адрес, необязательную строку или объект с данными и технически необязательную, но практически всегда используемую функцию обратного вызова. В первом аргументе функции обратного вызова передаются полученные данные, во втором - строка «success» и в третьем - объект XMLHttpRequest (если он использовался для выполнения запроса):
// Запросить текст с сервера и отобразить его в диалоге alert
jQuery.get("debug.txt", alert);
Помимо трех аргументов, описанных выше, эти две функции могут принимать четвертый необязательный аргумент (передается как третий аргумент, если дополнительные данные отсутствуют), который определяет тип запрашиваемых данных. Этот аргумент влияет на обработку полученных данных перед передачей их функции обратного вызова. Метод load() использует тип «html», jQuery.getScript() -тип «script», a jQuery.getJSON() -тип «json». Однако функции jQuery.get() и jQuery.post() более гибкие, чем эти специализированные утилиты, и им можно указать любой из этих типов. Допустимые значения этого аргумента и особенности поведения библиотеки jQuery при его отсутствии описываются во врезке.
Типы данных, поддерживаемые реализацией Ajax в библиотеке jQuery
Функциям jQuery.get() и jQuery.post() допускается передавать любой из шести типов данных. Кроме того, как описывается ниже, любой из этих типов можно также передавать функции jQuery.ajax() в виде параметра dataType:
"text”
Вернуть ответ сервера как простой текст, без дополнительной обработки.
"html"
Этот тип обрабатывается так же, как тип "text": ответ возвращается как простой текст. Этот тип используется методом load(), который вставляет текст ответа в документ.
"xml"
Предполагает, что URL-адрес ссылается на данные в формате XML, и для их получения вместо свойства responseText объекта XMLHttpRequest библиотека jQuery использует свойство responseXML. Функции обратного вызова передается не строка с текстом документа, а объект Document, представляющий XML-документ.
"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», ответ будет выполнен как сценарий. Иначе данные будут интерпретироваться как простой текст.
Оглавление книги
