瀏覽器的同源策略會攔截不同域名、不同連接埠或不同協議之間的請求。當我們需要把資料送到第三方服務(例如短信閘道、地圖服務、統計平台)時,就必須借助跨域手段。常見方案有三種:由後端伺服器代轉(CORS 標頭)、以 JSONP 進行腳本注入,或直接在伺服器端代理轉發。
下面以「發送驗證短信」這個典型場景為例,說明如何用 jQuery 撰寫非同步呼叫,並對介面回傳的各種狀態碼做出對應處理。
核心觀念是:async: true 讓請求在背景執行,不阻塞使用者的操作;dataType 則決定 jQuery 如何解析回應。若目標伺服器支援 CORS,直接以 text 或 json 接收即可;若對方只提供 JSONP 端點,則改為 jsonp 並在網址帶上 callback 參數。
$.ajax({
url: url,
type: 'POST',
data: {
CorpID: CorpID,
Pwd: Pwd,
Mobile: Mobile,
Content: Content,
Cell: '',
SendTime: ''
},
async: true, // 非同步執行
dataType: 'text', // 可改為 'json' 或 'jsonp'
success: function (data, textStatus) {
handleResult(data);
},
error: function (xhr, textStatus, errorThrown) {
alert('短信功能呼叫失敗,請聯繫管理員!');
}
});
原先把十幾個 if...else if 全部塞在 success 回呼裡,可讀性很差。改用查表(map)的方式,只需維護一份對照表,新增錯誤碼時也不必再動主流程。
var SMS_CODE = {
'0': '短信已發送成功,請注意查收!',
'-1': '帳號未註冊!',
'-2': '服務端發生其他錯誤。',
'-3': '帳號或密碼錯誤!',
'-4': '手機號碼格式不正確!',
'-5': '餘額不足,請先充值!',
'-6': '定時發送的時間格式無效!',
'-7': '禁止在 10 小時內向同一號碼重複發送相同內容!'
};
function handleResult(data) {
var msg = SMS_CODE[String(data)];
alert(msg || ('未定義的回傳碼:' + data));
}
第一,跨域並不會自動成立。單純把 dataType 寫成 jsonp 不會讓請求變成 JSONP,伺服器必須輸出 callback(...) 形式的內容,且請求方式會退化成 GET,敏感欄位(例如密碼)會暴露在網址列上,因此登入類介面不建議用 JSONP。
第二,非同步請求沒有回傳值。呼叫端無法用 return 取得結果,必須把後續邏輯寫進回呼,或改用 Promise/async-await 風格串接。
第三,error 回呼在跨域時資訊有限。若伺服器未送出 Access-Control-Allow-Origin,瀏覽器只會給出通用錯誤,此時應回到伺服器端檢查標頭設定,而不是在前端反覆試錯。