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 請求不受同源策略限製。