萬盛學電腦網

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

jQuery AJAX 完整參數詳解與緩存、亂碼、GET/POST 選擇指南

jQuery $.ajax() 是所有高層 AJAX 方法($.get、$.post、$.getJSON 等)的底層實現。掌握其完整參數選項,能精準控制請求行為、解決緩存、亂碼、跨域等疑難雜症。本文系統整理核心參數、常見陷阱與最佳實踐。

1. GET vs POST:核心差異與選擇原則

維度GETPOST
語義獲取資源,冪等、可緩存提交/修改資源,非冪等
參數傳遞URL QueryString(長度限制 ~2KB)Request Body(理論無上限)
瀏覽器緩存預設緩存(IE 強緩存)預設不緩存
安全性參數暴露於 URL/歷史/日誌參數在 Body,相對隱蔽
適用場景查詢、列表、靜態資源新增、修改、刪除、大數據提交
原則:查詢用 GET,變更用 POST。若 GET 參數含敏感信息或超長,強制改 POST。

2. $.ajax() 核心參數速查表(高頻項)

參數類型預設值關鍵說明
urlString當前頁請求地址
typeString'GET''GET' 或 'POST',亦支援 PUT/DELETE(瀏覽器兼容性自測)
dataObject/String—發送數據。Object 自動序列化為 key=val&...;String 直接發送
dataTypeString自動判斷'xml','html','script','json','jsonp','text'。指定後 jQuery 依此解析響應
cacheBooleantrue(GET)false 時在 URL 附加 _=timestamp 參數,繞過瀏覽器緩存
asyncBooleantruefalse 為同步請求(阻塞 UI,慎用)
timeoutNumber0(無限)毫秒數,超時觸發 error 回調
contentTypeString'application/x-www-form-urlencoded; charset=UTF-8'發送編碼類型。發送 JSON 時改為 'application/json; charset=utf-8'
processDataBooleantruefalse 時不序列化 data,直接發送(如 FormData、XML、JSON 字串)
beforeSendFunction(xhr)—發送前修改 XHR,如設置自定義 Header、Token
successFunction(data, status, xhr)—請求成功回調
errorFunction(xhr, status, err)—請求失敗回調
completeFunction(xhr, status)—完成回調(成功/失敗均執行)

3. 緩存控制最佳實踐

  • 查詢介面:type:'GET', cache:true(配合後端 Cache-Control),或手動加 _t:Date.now() 強制刷新。
  • 變更介面:type:'POST', cache:false(預設即 false)。
  • 全域關閉 GET 緩存:$.ajaxSetup({cache:false}),但需注意靜態資源(模板、配置)需單獨開啟緩存。

4. 亂碼問題根因與解決

現象原因解決
中文參數發送亂碼GET 參數未 encodeURIComponent手動 encodeURIComponent(val) 或改用 POST
響應中文亂碼響應頭無 charset 或 charset 不匹配後端設置 Content-Type: application/json; charset=utf-8;前端頁面 <meta charset="utf-8">
POST 發送 JSON 亂碼contentType 未設為 application/jsoncontentType:'application/json; charset=utf-8', data: JSON.stringify(obj)

5. 完整範例:帶 Token 驗證、錯誤統一處理、Loading 狀態

$.ajax({
    url: '/api/users',
    type: 'POST',
    dataType: 'json',
    contentType: 'application/json; charset=utf-8',
    data: JSON.stringify({ name: 'Tom', age: 28 }),
    timeout: 8000,
    beforeSend: function (xhr) {
        xhr.setRequestHeader('Authorization', 'Bearer ' + getToken());
        $('#loading').show();
    },
    success: function (res) {
        if (res.code === 0) renderUser(res.data);
        else showError(res.msg);
    },
    error: function (xhr, status, err) {
        var msg = status === 'timeout' ? '請求超時' : '網絡異常:' + err;
        showError(msg);
    },
    complete: function () {
        $('#loading').hide();
    }
});

6. 常見坑點提醒

  1. dataType:'jsonp' 時,type 強制為 GET,cache 預設 false。
  2. data 為 Object 時,jQuery 會用 $.param() 序列化,數組會展開為 key=val1&key=val2;若後端需接收數組,確保命名一致(如 ids[] 或 ids)。
  3. 跨域請求需後端支援 CORS(Access-Control-Allow-Origin),或使用 JSONP(僅 GET)。
  4. 同步請求 (async:false) 已被標準棄用,會阻塞主線程,嚴禁生產環境使用。

熟練掌握 $.ajax() 參數,是前端工程師處理網絡層疑難雜症的基石。

copyright © 萬盛學電腦網 all rights reserved