JQuery 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 结构定义并使用 $.parseJSON() 方法解析的 JavaScript 对象或数组。它还传递了响应的文本状态。

从 jQuery 1.5 开始， 这success回调函数接收一个"jqXHR" 对象(在jQuery 1.4，它收到了XMLHttpRequest目的)。但是，由于 JSONP 和 cross-domain GET 请求不使用XHR, 在这些情况下jqXHR和textStatus传递给成功回调的参数未定义。

JSONP

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

jqXHR 对象

从 jQuery 1.5 开始，所有 jQuery 的 Ajax 方法都返回一个超集XMLHTTPRequest目的。这个 jQuery XHR 对象，或 "jqXHR," 返回$.getJSON()实现 Promise 接口，为其提供 Promise 的所有属性、方法和行为(参见延迟对象了解更多信息)。这jqXHR.done()(为了成功)，jqXHR.fail()(对于错误)，和jqXHR.always()(用于完成，无论是成功还是错误；在 jQuery 1.6 中添加)方法采用一个函数参数，该参数在请求终止时调用。有关此函数接收的参数的信息，请参阅jqXHR 对象的部分$.ajax()文档。

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" 请求都受制于 same origin policy ；请求无法从不同的域、子域、端口或协议成功检索数据。
• 脚本和 JSONP 请求不受同源策略限制。