承接上一篇談到的 JSONP 錯誤回呼問題,這篇記錄實際使用 jquery-jsonp 外掛時踩到的兩個小坑,都很基本但很容易讓人卡上半天。
var originImgSrc = 'cnbogs-logo.gif';
$.jsonp({
url: '',
data: { imgSrc: originImgSrc },
callbackParameter: "callback",
success: function (newImgSrc, textStatus, xOptions) {
console.log(xOptions.data.imgSrc);
},
error: function (xOptions, textStatus) { }
});
如果後端沒有自己定義 callback 函式名稱,那麼 callbackParameter 一定要明確寫成 "callback"。這個參數決定的是「用哪個查詢參數名傳 callback 函式名稱」,多數標準 JSONP 服務都採用 callback 這個慣例;寫錯或漏寫,後端就回不出可被前端執行的包裹格式,請求看起來成功但資料永遠是 undefined。
第二個坑更隱蔽。在 success 裡直接寫 originImgSrc,你會得到 undefined,必須改寫成 xOptions.data.imgSrc 才拿得到值。
這不是外掛的 bug,而是 JSONP 的先天限制:由於請求是透過動態 script 標籤發出,該請求已經脫離原本的執行上下文,外掛只能靠 xOptions 這個設定物件把當初傳入的參數一包一包帶回來。換句話說,在 JSONP 的回呼裡,不要假設外層變數還在,凡是需要的值都從 xOptions 上取。
這也是為什麼複雜的 JSONP 呼叫通常會把請求描述物件先組好、再整包傳入——除了可讀性,更是為了讓回呼階段有可靠的資料來源。若你的情境允許,直接改用 CORS 搭配原生 XHR 會少掉這類心智負擔。