萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 三大 AJAX 請求方式對比:$.get、$.post、$.getJSON 使用指南與跨域解析

jQuery AJAX 入門三部曲:GET、POST、JSONP 選型、參數傳遞、回調處理與跨域原理

jQuery 封裝了三種最常用的 AJAX 簡寫方法:$.get、$.post、$.getJSON。本文詳細對比三者差異、適用場景、參數用法、跨域機制(JSONP),並提供實戰程式碼範例與避坑指南。

一、三大方法簽名對比

方法HTTP Method資料傳遞回傳資料類型跨域支援適用場景
$.getGETQuery String自動判斷 (xml, json, script, text, html)否 (同源策略)單純查詢、冪等操作、SEO 友善
$.postPOSTRequest Body (form/data)自動判斷否 (同源策略)提交表單、修改資料、非冪等操作
$.getJSONGETQuery String + callback 參數強制 JSON是 (JSONP)跨域讀取公開 API、CDN 資料

二、$.get 範例:查詢用戶列表

$.get('/api/users', {
    page: 1,
    limit: 20,
    keyword: 'john'
}, function (data, textStatus, jqXHR) {
    // data: 解析後的物件/陣列 (視 Content-Type)
    // textStatus: 'success' / 'error' / 'notmodified' ...
    // jqXHR: 包裝後的 XMLHttpRequest
    console.log('用戶列表:', data);
    renderUserTable(data);
}).fail(function (jqXHR, textStatus, errorThrown) {
    console.error('請求失敗:', textStatus, errorThrown);
});

三、$.post 範例:新增用戶

$.post('/api/users', {
    username: 'john_doe',
    email: 'john@example.com',
    role: 'admin'
}, function (res, textStatus, jqXHR) {
    if (res.success) {
        alert('建立成功,ID: ' + res.data.id);
    } else {
        alert('失敗: ' + res.message);
    }
}, 'json') // 明確指定期望回傳 JSON,避免自動判斷失誤
.fail(function (jqXHR) {
    if (jqXHR.status === 422) {
        var errors = jqXHR.responseJSON.errors;
        showValidationErrors(errors);
    }
});

四、$.getJSON 範例:跨域獲取公開資料 (JSONP)

// 跨域 API 必須支援 JSONP (回呼函式名稱參數通常為 callback/jsonpCallback)
$.getJSON('https://api.example.com/v1/public-data?callback=?', {
    category: 'news',
    limit: 10
}, function (data) {
    // 成功回調,data 為解析後的 JSON 物件
    console.log('跨域資料:', data);
}).fail(function (jqXHR, textStatus, errorThrown) {
    console.error('JSONP 請求失敗:', textStatus, errorThrown);
    // 注意:JSONP 失敗無法獲取 HTTP 狀態碼,errorThrown 通常為 'Error: jQuery... timeout'
});

JSONP 原理圖解

  1. 前端產生隨機回呼函式名 jQuery123456789,註冊為全域函式。
  2. 請求 URL 附加 callback=jQuery123456789。
  3. 後端回傳 jQuery123456789({...JSON...})(JavaScript 執行語句)。
  4. 瀏覽器執行該腳本 → 觸發前端回呼函式 → jQuery 清理全域函式 → 進入 success 回調。

限制:僅支援 GET、無法獲取 HTTP 狀態碼/Headers、需後端配合輸出函式呼叫格式、有 XSS 風險(只信任可信域名)。

五、統一錯誤處理與攔截器

// 全域 AJAX 事件 (jQuery 1.8+ 推薦用 .ajaxSetup 或攔截器)
$.ajaxSetup({
    // 統一加入 CSRF Token
    beforeSend: function (xhr) {
        xhr.setRequestHeader('X-CSRF-Token', $('meta[name=csrf-token]').attr('content'));
    },
    // 統一錯誤提示
    error: function (jqXHR, textStatus, errorThrown) {
        if (jqXHR.status === 401) {
            location.href = '/login?redirect=' + encodeURIComponent(location.pathname);
        } else if (jqXHR.status === 403) {
            alert('權限不足');
        } else {
            console.error('AJAX 錯誤:', textStatus, errorThrown);
        }
    }
});

六、現代替代方案:Fetch API / Axios

// Fetch (原生、Promise-based)
fetch('/api/users', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ name: 'John' })
}).then(r => r.json()).then(data => console.log(data));

// Axios (功能豐富、攔截器、TypeScript 友善)
axios.post('/api/users', { name: 'John' })
    .then(res => console.log(res.data))
    .catch(err => console.error(err.response?.data || err.message));

建議:新專案優先使用 Axios 或原生 Fetch,jQuery AJAX 適用於維護舊專案或輕量頁面不想引入額外依賴的情況。

七、避坑檢查清單

  1. 資料序列化:$.post 預設 application/x-www-form-urlencoded,送 JSON 需 contentType: 'application/json' + JSON.stringify(需用 $.ajax)。
  2. 快取問題:GET 請求 IE 快取積極,加 cache: false 或時間戳參數。
  3. 跨域 CORS vs JSONP:現代專案優先 CORS(後端設定 Access-Control-Allow-Origin),JSONP 為 legacy 方案。
  4. 記憶體洩漏:長輪詢/定時請求務必在元件銷毀時 abort() 或取消訂閱。

熟練掌握三大方法差異與現代替代方案,讓資料交互開發更得心應手。

copyright © 萬盛學電腦網 all rights reserved