DIV CSS 佈局教程網

jQuery 非同步取得 JSON 資料的兩種寫法:$.getJSON 與 $.ajax
編輯:JQuery特效代碼     

在 Web 開發裡,從後端抓一份 JSON 回來渲染到頁面,是最日常不過的操作。jQuery 提供了兩條路:$.getJSON 與 $.ajax。以下用同一份資料分別實作,並說明該怎麼選。

先在根目錄建立 data.json:

{
    "one": "Hello",
    "two": "World"
}

做法一:$.getJSON

這是專門為 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>

做法二:$.ajax

明確指定 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 已經是標準寫法,語意比回呼式清楚得多,值得一併掌握。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved