又被打回 JS 戰場,跨域這個老傷疤也跟著疼起來。好在有 jQuery 幫忙,這次趁機會把整個問題刨根問底,也算徹底解決了。
跨域安全限制針對的是瀏覽器端。伺服器端完全沒有這個問題,所以「由本機伺服器去代理請求外部資源,瀏覽器再向本機要資料」這種間接做法一定行得通,限制也最少。缺點是開發量較大。許多開放平台的 server 端其實就是這樣運作的。這不是本文重點,以下談的是瀏覽器端的直接跨域。
var qsData = {
'searchWord': $("#searchWord").attr("value"),
'currentUserId': $("#currentUserId").attr("value"),
'conditionBean.pageSize': $("#pageSize").attr("value")
};
$.ajax({
async: false,
url: "https://example.com/document!searchJSONResult.action",
type: "GET",
dataType: 'jsonp',
jsonp: 'jsoncallback',
data: qsData,
timeout: 5000,
success: function(json){
if (json.actionErrors.length != 0) {
alert(json.actionErrors);
}
genDynamicContent(qsData, type, json);
},
complete: function(XMLHttpRequest, textStatus){
$.unblockUI({ fadeOut: 10 });
},
error: function(xhr){
alert("請求出錯,請檢查網路狀況");
}
});
這裡有個很重要、但很多人會踩到的細節:使用 dataType: 'jsonp' 時,beforeSend 與 error 這兩個回呼不會被觸發。原因很直接——這種模式下已經不是真正的 Ajax 了,沒有 XMLHttpRequest 對象,自然也沒有原生意義上的請求失敗事件。想做錯誤處理,得靠 timeout 自行判斷。
$.getJSON("https://example.com/document!searchJSONResult.action?name1=" + value1 + "&jsoncallback=?",
function(json){
if (json.屬性名 == 值) {
// 執行程式
}
});
這個寫法其實是上面那個 $.ajax({...}) 呼叫的高階包裝,底層一些參數被封裝起來看不到。jQuery 會把問號替換成一個隨機產生的函式名稱,拼出類似這樣的 GET 請求:
https://example.com/document!searchJSONResult.action?
jsoncallback=jsonp1236827957501&_=1236828192549
&searchWord=範例¤tUserId=5351&conditionBean.pageSize=15
回應端需要完成三步:
request.getParameter("jsoncallback") 取得 jQuery 傳來的函式名稱,例如 jsonp1236827957501。jsonp1236827957501({...資料...});。application/javascript 或 text/javascript。瀏覽器收到後會執行這段 script,也就等於呼叫了 jsonp1236827957501(json 資料),資料於是交到了客戶端預先定義好的回呼函式裡。
JSONP 最基本的原理就是動態新增一個 <script> 元素,因為 script 標籤的 src 屬性不受同源政策限制。這也說明了一件事:這種跨域方式其實和 Ajax、XMLHttpRequest 一點關係都沒有。
換個角度說,「jQuery 的 Ajax 跨域問題」其實是個有點誤導的命題。當你把 dataType 設為 'jsonp',$.ajax 這個方法名就不再名副其實,底下跑的是 JSONP 協議。
JSONP 是非官方協議,全名 JSON with Padding。它允許伺服器端把 script 標籤回傳給客戶端,透過 JavaScript 回呼的形式實現跨域。
jsoncallback),並把實際產生的函式名稱(例如 jsonp1236827957501)當參數傳給伺服器。jsonp1236827957501(資料) 的形式回傳。本質上這與 <script src="https://跨域/xxx.js"></script> 是一致的做法。
安全性:JSONP 是一種 script 注入行為。伺服器回傳的任何程式碼都會在你的頁面上執行,因此只能對完全信任的來源使用。若目標端點會接受使用者輸入並回顯到 callback 中,還可能造成 XSS。
只支援 GET:jQuery 不支援 POST 方式的跨域。有人用「POST + 動態產生 iframe」硬做出來(也有人直接改 jQuery 1.2.5 的原始碼),但那屬於極端做法,不建議採用。可以說 GET 跨域是協議層面認可的,POST 從安全角度被視為不合法,萬不得已不要走偏門。
錯誤處理困難:如前所述,error 回呼不會觸發,加上 script 載入失敗不會丟出可攔取的例外,除錯體驗很差。
今天若要在伺服器之間開放資料,正解是 CORS:由伺服器回應 Access-Control-Allow-Origin 標頭,瀏覽器便允許該來源讀取回應。它支援所有 HTTP 方法、錯誤處理正常,也不需要把資料包成函式呼叫。
// Node.js / Express 的最小設定
res.setHeader('Access-Control-Allow-Origin', 'https://your-domain.com');
res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
若需要跨來源傳送 cookies,兩端都要明確開啟 credentials(前端設 xhrFields: { withCredentials: true },後端回 Access-Control-Allow-Credentials: true 且不可使用萬用字元)。HTML5 的 WebSocket 協定本身也支援跨來源資料交換,是另一個選項。