在 Web 開發裡,從後端抓一份 JSON 回來渲染到頁面,是最日常不過的操作。jQuery 提供了兩條路:$.getJSON 與 $.ajax。以下用同一份資料分別實作,並說明該怎麼選。
先在根目錄建立 data.json:
{
"one": "Hello",
"two": "World"
}
這是專門為 JSON 設計的捷徑,等於預先設定好 dataType: "json" 的 ajax 呼叫。
<script src="Scripts/jquery-2.1.1.min.js"></script>
<script type="text/javascript">
$(function () {
$.getJSON('data.json', function (data) {
var items = [];
$.each(data, function (key, val) {
items.push('<li id="' + key + '">' + val + '</li>');
});
$('<ul/>', {
'class': 'list',
html: items.join('')
}).appendTo('body');
});
});
</script>

明確指定 dataType 與各項回呼,控制粒度更細。
<script src="Scripts/jquery-2.1.1.min.js"></script>
<script type="text/javascript">
$(function () {
$.ajax({
url: 'data.json',
dataType: 'json',
success: function (data) {
var items = [];
$.each(data, function (key, val) {
items.push('<li id="' + key + '">' + val + '</li>');
});
$('<ul/>', {
'class': 'list',
html: items.join('')
}).appendTo('body');
},
statusCode: {
404: function () {
alert("沒有找到相關檔案~~");
}
}
});
});
</script>
兩者能達到完全相同的結果。若只需要最簡單的「抓了就渲染」,用 $.getJSON 更精簡;若需要更細緻的控制,就用 $.ajax。
所謂更細緻的控制,實際上包含這些常見需求:
錯誤處理。$.getJSON 若請求失敗是靜默的,畫面什麼都不發生,使用者一頭霧水。$.ajax 可以設定 error 回呼或 statusCode 針對 404、500 分別處理,這在實務上幾乎是必需品。
逾時設定。加上 timeout 參數,避免請求卡住時 loading 訊號永遠轉不停。
請求前的加工。beforeSend 可以加上驗證 token、顯示進度條,或在送出前修改標頭。
快取控制。用 cache: false 避免 IE 對 GET 請求的預設快取造成資料不更新。
用本機 file:// 開啟會失敗。由於同源政策,直接雙擊 HTML 檔時瀏覽器多半會拒絕讀取本機 JSON。測試時請起一個簡易的 HTTP 服務(例如 python -m http.server)。
資料要轉義後再插入。示範用字串拼接組出 li,若 JSON 內容可能含有使用者輸入或外部資料,請改用 $('<li>', { text: val }) 這類以 text 設值的方式,避免 XSS。
最後補充:在不用 jQuery 的專案裡,原生的 fetch() 搭配 async/await 已經是標準寫法,語意比回呼式清楚得多,值得一併掌握。