DIV CSS 佈局教程網

jQuery 非同步跨域請求實戰:以短信推送介面為例
編輯:JavaScript綜合知識     

為什麼需要跨域請求

瀏覽器的同源策略會攔截不同域名、不同連接埠或不同協議之間的請求。當我們需要把資料送到第三方服務(例如短信閘道、地圖服務、統計平台)時,就必須借助跨域手段。常見方案有三種:由後端伺服器代轉(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,瀏覽器只會給出通用錯誤,此時應回到伺服器端檢查標頭設定,而不是在前端反覆試錯。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved