jQuery.getJSON()

Это сокращенная Ajax функция, которая эквивалентна следующему коду:

$.ajax({
  dataType: "json",
  url: url,
  data: data,
  success: success
});

Данные отправляемые на сервере передаются в URL строке как GET параметры. Если значением параметра data является объект (не строка), то он конвертируется в строку (с предварительным url-encode кодированием значений) перед добвлением к URL адресу.

В большинстве случаев, обработчик success указывается:

$.getJSON( "ajax/test.json", function( data ) {
  var items = [];
  $.each( data, function( key, val ) {
    items.push( "<li id='" + key + "'>" + val + "</li>" );
  });
 
  $( "<ul/>", {
    "class": "my-new-list",
    html: items.join( "" )
  }).appendTo( "body" );
});

Этот пример, конечно, зависит от структуры запрошенного JSON файла:

{
  "one": "Singular sensation",
  "two": "Beady little eyes",
  "three": "Little birds pitch by my doorstep"
}

Используя такую структуру, в примере происходит перебор запрошенных данных, строится неупорядоченный список и добавляет его к body.

В функцию обратного вызова success передаются возвращенные данные с сервера, которые обычно представляют из себя JavaScript объект или массив, соотвествующий формату JSON, - полученные при помощи метода $.parseJSON(). Также передается текстовый статус ответа.

Начиная с jQuery 1.5, функция success принимает объект "jqXHR" object (в jQuery 1.4, она принимает объект XMLHttpRequest). Однако, так как JSONP и кросс-доменные запросы не используют XHR, то в этом случае параметры jqXHR и textStatus не будут переданы в функцию success.

JSONP

Если в URL адрес включена строка "callback=?" (или подобные, как это определяет серверное API), запрос обрабатывается как JSONP. Это более подробно описано на странице $.ajax() в описании параметра jsonp.

The jqXHR Object

Начиная с jQuery 1.5, все Ajax методы jQuery возвращают объект XMLHTTPRequest. Объект jQuery XHR или "jqXHR," возвращается $.get() реализацией интерфейса Promise и предоставляет все его свойства, меоды и повередени Promise в целом (смотрите Deferred object для справки). Методы jqXHR.done() (успех), jqXHR.fail() (ошибка), and jqXHR.always() (для гарантированного обработчика, не зависимо от успеха или ошибки ответа, добавлен в версии jQuery 1.6) принимают функцию, которая вызывается когда запрос завершается. Аргументы этих функция описаны на странице jqXHR Object в разделе $.ajax() справки.

Интерфейс Promise также разрешает Ajax методам, включая $.get(), вызывать неоднократно по цепочке методы .done(), .fail() и .always() для одного запроса и даже назначать его обработчики, даже после того как запрос был завершен. Если запрос уже выполнен, то функция обратного вызова выполняется немедленно.

// Assign handlers immediately after making the request,
// and remember the jqxhr object for this request
var jqxhr = $.getJSON( "example.json", function() {
  console.log( "success" );
})
  .done(function() {
    console.log( "second success" );
  })
  .fail(function() {
    console.log( "error" );
  })
  .always(function() {
    console.log( "complete" );
  });
 
// Perform other work here ...
 
// Set another completion function for the request above
jqxhr.complete(function() {
  console.log( "second complete" );
});

Уведомление об устаревании

Функции обратного вызова jqXHR.success(), jqXHR.error(), and jqXHR.complete() удалены в jQuery 3.0. Используйте методы jqXHR.done(), jqXHR.fail() и jqXHR.always() вместо них.

• Из-за ограничений безопасности браузера большинство "Ajax" запросов подпадают под действие политики того же происхождения, запросы не могут быть выполнены к другим доменам, поддоменам, порту или протоколу.
• Запросы скриптов и JSONP запросы не подвергаются ограничениям политики того же происхождения (Same Origin Policy).