jQuery.getJSON()

这是一个简写 Ajax 函数，等效于

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

发送到服务器的数据作为查询字符串附加到 URL。如果 data 参数的值是普通对象，则在将其附加到 URL 之前将其转换为字符串并进行 URL 编码。

大多数实现将指定一个成功处理程序

$.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"
}

使用此结构，示例将遍历请求的数据，构建一个无序列表，并将其附加到主体。

success 回调函数将传递返回的数据，该数据通常是 JSON 结构定义的 JavaScript 对象或数组，并使用 $.parseJSON() 方法进行解析。它还将传递响应的文本状态。

从 jQuery 1.5 开始，success 回调函数接收一个 "jqXHR" 对象（在 jQuery 1.4 中，它接收 XMLHttpRequest 对象）。但是，由于 JSONP 和跨域 GET 请求不使用 XHR，因此在这些情况下传递给成功回调的 jqXHR 和 textStatus 参数未定义。

JSONP

如果 URL 包含字符串“callback=?”（或类似的，由服务器端 API 定义），则请求将被视为 JSONP。有关更多详细信息，请参阅 $.ajax() 中对 jsonp 数据类型的讨论。

jqXHR 对象

从 jQuery 1.5 开始，所有 jQuery 的 Ajax 方法都返回 XMLHTTPRequest 对象的超集。此 jQuery XHR 对象（或“jqXHR”）由 $.getJSON() 返回，它实现了 Promise 接口，赋予它 Promise 的所有属性、方法和行为（有关更多信息，请参阅 Deferred 对象）。jqXHR.done()（用于成功）、jqXHR.fail()（用于错误）和 jqXHR.always()（用于完成，无论成功还是错误；在 jQuery 1.6 中添加）方法接受一个函数参数，该参数在请求终止时被调用。有关此函数接收的参数的信息，请参阅 $.ajax() 文档的 jqXHR 对象 部分。

jQuery 1.5 中的 Promise 接口还允许 jQuery 的 Ajax 方法（包括 $.getJSON()）在一个请求上链接多个 .done()、.always() 和 .fail() 回调，甚至在请求可能已完成之后分配这些回调。如果请求已完成，则立即触发回调。

// 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.always(function() {
  console.log( "second complete" );
});

弃用通知

jqXHR.success()、jqXHR.error() 和 jqXHR.complete() 回调方法从 jQuery 3.0 开始被移除。您可以使用 jqXHR.done()、jqXHR.fail() 和 jqXHR.always() 代替。

• 由于浏览器安全限制，大多数“Ajax”请求都受 同源策略 的约束；请求无法成功从不同的域、子域、端口或协议检索数据。
• 脚本和 JSONP 请求不受同源策略限制。