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

19.6.2. Вспомогательные функции поддержки Ajax

Другие высокоуровневые утилиты поддержки архитектуры Ajax в библиотеке jQuery являются функциями, а не методами и вызываются относительно глобального имени

или , а не относительно объекта с выбранными элементами. Функция загружает и выполняет файлы со сценариями на языке JavaScript. Функция загружает содержимое URL и разбирает его как текст в формате JSON, а получившийся в результате объект передает указанной функции обратного вызова. Обе эти функции вызывают функцию , которая является более универсальной функцией загрузки данных из указанного URL-адреса. Наконец, функция действует подобно функции но выполняет HTTP-запрос методом POST, а не GET. Как и метод все эти функции выполняются асинхронно: они возвращают управление еще до того, как будут загружены какие-либо данные, и извещают программу о результатах посредством указанной функции обратного вызова.

19.6.2.1. jQuery.getScript()

Функция

принимает в первом аргументе URL-адрес файла со сценарием на языке JavaScript. Она асинхронно загружает и выполняет этот сценарий в глобальной области видимости. Выполняться могут сценарии как общего происхождения с документом, так и сторонние:

Во втором аргументе можно передать функцию обратного вызова, и в этом случае библиотека jQuery вызовет ее сразу после того, как загруженный сценарий будет выполнен.

Для получения текста сценария, который должен быть выполнен, функция

обычно использует объект . Но для выполнения междоменных запросов (когда сценарий поставляется сервером, отличным от того, откуда был получен текущий документ), библиотека jQuery использует элемент (раздел 18.2). Если запрос удовлетворяет ограничениям политики общего происхождения, в первом аргументе функции обратного вызова передается текст сценария, во втором - код состояния «success» и в третьем - объект , использовавшийся для получения текста сценария. Возвращаемым значением функции в данном случае также является объект . Для междоменных запросов, которые выполняются без участия объекта , текст сценария не сохраняется. В этом случае в первом и третьем аргументах функции обратного вызова передается значение undefined, и возвращаемым значением функции также является значение undefined.

Функция обратного вызова, передаваемая функции

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

19.6.2.2. jQuery.getJSON()

Функция

подобна функции она загружает текст и затем обрабатывает его особым образом перед вызовом указанной функции обратного вызова. Функция не выполняет загруженный текст как сценарий, а выполняет синтаксический разбор этого текста как данных в формате JSON (используя функцию описывается в разделе 19.7). Функцию имеет смысл использовать, только когда ей передается функция обратного вызова. Если содержимое URL было благополучно загружено и разобрано, как данные в формате JSON, то полученный в результате объект передается функции обратного вызова в первом аргументе. Как и при использовании функции , во втором и третьем аргументах передаются код состояния «success» и объект :

Большинство методов поддержки архитектуры Ajax в библиотеке jQuery принимают аргумент (или параметр), определяющий данные для отправки на сервер вместе с URL. Обычно эти данные принимают вид строки, закодированной в формате URL, пар имя/значение, отделяющихся друг от друга символами амперсанда. (Этот формат представления данных известен, как MIME-тип «application/x-www-form-urlencoded». Его можно рассматривать как аналог формата JSON - формата представления простых JavaScript-объектов в виде строк.) При выполнении HTTP-запросов методом GET эта строка с данными добавляется в конец URL-адреса запроса. При выполнении запросов методом POST она отправляется в теле запроса после отправки НТТР-заголовков.

Получить строку с данными в этом формате можно с помощью метода

объекта , содержащего формы или элементы формы. Отправить, например, HTML-форму с помощью метода load() можно следующим образом: