萬盛學電腦網

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

jQuery AJAX JSONP 跨域調用完整指南:原理、參數與實戰案例

JSONP 原理速覽

瀏覽器同源策略限制 Ajax 跨域,但 <script> 標籤不受限制。JSONP 利用此特性:

  1. 客戶端聲明全局回調函數 callbackName(data)
  2. 請求 URL 附帶 ?callback=callbackName
  3. 服務端返回 callbackName({...json數據...})
  4. 瀏覽器執行腳本,觸發回調,獲得數據

jQuery JSONP 核心參數

參數說明
dataType: 'jsonp'啟用 JSONP 模式
jsonp: 'callback'URL 參數名(默認 callback)
jsonpCallback: 'fnName'指定回調函數名(可選,默認隨機)
cache: true允許緩存(默認 false 防緩存)

完整客戶端代碼

// 方式 1:自動回調名(推薦)
$.ajax({
    url: 'https://api.example.com/data',
    dataType: 'jsonp',
    data: {param1: 'value1'},
    success: function(data) {
        console.log('數據:', data);
    },
    error: function(jqXHR, textStatus, errorThrown) {
        console.error('JSONP 失敗:', textStatus, errorThrown);
    }
});

// 方式 2:固定回調名(需配合服務端)
$.ajax({
    url: 'https://api.example.com/data',
    dataType: 'jsonp',
    jsonpCallback: 'myFixedCallback', // 全局函數名
    success: function(data) { /* ... */ }
});

// 全局定義(需在 ajax 前聲明)
window.myFixedCallback = function(data) {
    console.log('固定回調收到:', data);
};

服務端實現 (多語言示例)

Node.js (Express)

app.get('/data', (req, res) => {
    const callback = req.query.callback || req.query.jsonpCallback;
    const data = {code: 0, msg: 'ok', data: {id: 1, name: 'Test'}};
    
    if (callback) {
        // JSONP 響應
        res.type('application/javascript');
        res.send(`${callback}(${JSON.stringify(data)})`);
    } else {
        // 普通 JSON
        res.json(data);
    }
});

Java (Spring MVC)

@GetMapping("/data")
public void jsonp(HttpServletRequest req, HttpServletResponse resp) 
        throws IOException {
    String callback = req.getParameter("callback");
    String json = "{\"code\":0,\"data\":{\"id\":1}}";
    
    resp.setContentType("application/javascript;charset=UTF-8");
    if (callback != null) {
        resp.getWriter().write(callback + "(" + json + ")");
    } else {
        resp.getWriter().write(json);
    }
}

PHP

 0, 'data' => ['id' => 1]];
$json = json_encode($data);

if ($callback) {
    header('Content-Type: application/javascript; charset=utf-8');
    echo $callback . '(' . $json . ')';
} else {
    header('Content-Type: application/json; charset=utf-8');
    echo $json;
}
?>

實戰案例:拉勾招聘數據展示

<div id="lagouData">加載中...</div>

<script>
function renderLagou(data) {
    var html = '<ul>';
    $.each(data, function(i, job) {
        if (i >= 10) return false; // 只顯示前 10
        var title = '【' + job.city + '】' + job.positionName + ' (' + job.salary + ') - ' + job.companyName;
        if (title.length > 20) title = title.substring(0, 19) + '...';
        html += '<li><a href="' + job.posiitonDetailUrl + '" target="_blank" title="' + 
                job.city + ' ' + job.positionName + '">' + title + '</a></li>';
    });
    html += '</ul><a href="https://www.lagou.com" target="_blank">更多職位</a>';
    $('#lagouData').html(html);
}

// JSONP 請求
$.ajax({
    url: 'https://www.lagou.com/join/listW3cplus',
    data: {kd: '前端開發'},
    dataType: 'jsonp',
    jsonpCallback: 'renderLagou', // 指定回調
    cache: true,
    success: renderLagou // 兼容性寫法
});
</script>

JSONP vs CORS 對比

特性JSONPCORS
HTTP 方法僅 GET全部 (GET/POST/PUT/DELETE...)
安全性低 (腳本注入風險)高 (受同源策略保護)
錯誤處理困難 (無狀態碼)完整 (status, response)
請求體不支持支持
瀏覽器支持極廣 (IE6+)IE10+ (IE8/9 需 XDomainRequest)

安全建議

  • ✅ 僅用於公開只讀數據(如公開 API、廣告流、招聘信息)
  • ✅ 驗證回調函數名:服務端白名單校驗 callback 參數,防 XSS
  • ✅ 設置 CSP:script-src 'self' https://trusted-api.com
  • ❌ 絕不用於敏感操作(登錄、支付、用戶私有數據)
  • 🔄 新項目優先用 CORS,JSONP 作為舊瀏覽器降級方案
copyright © 萬盛學電腦網 all rights reserved