萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> 資料庫綜合

jQuery 跨域獲取 JSONP 數據完整指南:$.getJSON 與 $.ajax 深度對比

解決瀏覽器同源策略限制的標準方案

JSONP(JSON with Padding)利用 <script> 標籤不受同源策略限制的特性,實現跨域數據獲取。本文通過 PHP 後端示例,對比 jQuery 兩種調用方式的異同與坑點。

後端實現(PHP)

<?php
// jsonp.php
$callback = $_GET['callback']; // jQuery 自動生成的回調函數名
$data = [
    ['name' => '張三', 'sex' => '男', 'age' => 24],
    ['name' => '李四', 'sex' => '男', 'age' => 26]
];
header('Content-Type: application/javascript; charset=utf-8');
echo $callback . '(' . json_encode($data) . ');'; // 輸出:jQuery1234567([...]);
?>

方式一:$.getJSON(簡便但有限制)

$.getJSON("https://api.example.com/jsonp.php?callback=?", function(json) {
    console.log(json[0].name); // 注意:返回是數組,非單個對象
});
  • 關鍵點:callback=? 中的 ? 必須保持原樣,jQuery 會自動替換為生成的回調函數名(如 jQuery1234567)。自定義回調名會導致跨域失敗。
  • 返回數據結構取決於後端:示例中為對象數組,需用 json[0].name 訪問。

方式二:$.ajax(完全控制,推薦生產環境)

$.ajax({
    type: "GET",
    url: "https://api.example.com/jsonp.php",
    dataType: "jsonp",
    jsonp: "callback",        // 參數名,默認 callback,與後端 $_GET['callback'] 對應
    jsonpCallback: "myCallback", // 自定義回調函數名,或 "?" 讓 jQuery 生成
    success: function(json) {
        console.log(json[0].name);
    },
    error: function(xhr, status, err) {
        console.error("JSONP 請求失敗:", status, err);
    }
});

// 若使用 jsonpCallback: "myCallback",需定義全局函數
function myCallback(arr) {
    console.log("自定義回調:", arr[0].name);
}

核心差異對比表

特性$.getJSON$.ajax (jsonp)
回調函數名控制不可控(必須用 ?)可自定義或自動生成
錯誤處理無 error 回調支持 error/complete
超時控制不支持支持 timeout 參數
請求前處理不支持支持 beforeSend
緩存控制cache 參數無效支持 cache: false

常見坑點避雷

  1. 後端未輸出回調包裹:直接輸出 JSON 會導致語法錯誤,必須輸出 callbackName(jsonData)。
  2. Content-Type 錯誤:建議設置 application/javascript,避免瀏覽器誤解析。
  3. 數據結構不匹配:前後端約定好是對象還是數組,示例中後端返回數組,前端需用索引訪問。
  4. JSONP 僅支持 GET:大數據傳輸受 URL 長度限制,需改用 CORS 或代理方案。

掌握兩種方式優劣,根據項目需求選擇最適配的跨域數據獲取方案。

copyright © 萬盛學電腦網 all rights reserved