DIV CSS 佈局教程網

jQuery 跨域訪問完整解析:JSONP 的原理與實作細節
編輯:JQuery特效代碼     

又被打回 JS 戰場,跨域這個老傷疤也跟著疼起來。好在有 jQuery 幫忙,這次趁機會把整個問題刨根問底,也算徹底解決了。

先釐清一件事:限制只存在於瀏覽器

跨域安全限制針對的是瀏覽器端。伺服器端完全沒有這個問題,所以「由本機伺服器去代理請求外部資源,瀏覽器再向本機要資料」這種間接做法一定行得通,限制也最少。缺點是開發量較大。許多開放平台的 server 端其實就是這樣運作的。這不是本文重點,以下談的是瀏覽器端的直接跨域。

實際案例:以 $.ajax 走 GET 跨域

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 是它的語法糖

$.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=範例&currentUserId=5351&conditionBean.pageSize=15

伺服器端要做什麼

回應端需要完成三步:

  1. 用 request.getParameter("jsoncallback") 取得 jQuery 傳來的函式名稱,例如 jsonp1236827957501。
  2. 把回應內容組成一個 Script 標籤形式:jsonp1236827957501({...資料...});。
  3. Content-Type 設為 application/javascript 或 text/javascript。

瀏覽器收到後會執行這段 script,也就等於呼叫了 jsonp1236827957501(json 資料),資料於是交到了客戶端預先定義好的回呼函式裡。

原理:動態插入 script 標籤

JSONP 最基本的原理就是動態新增一個 <script> 元素,因為 script 標籤的 src 屬性不受同源政策限制。這也說明了一件事:這種跨域方式其實和 Ajax、XMLHttpRequest 一點關係都沒有。

換個角度說,「jQuery 的 Ajax 跨域問題」其實是個有點誤導的命題。當你把 dataType 設為 'jsonp',$.ajax 這個方法名就不再名副其實,底下跑的是 JSONP 協議。

JSONP 是非官方協議,全名 JSON with Padding。它允許伺服器端把 script 標籤回傳給客戶端,透過 JavaScript 回呼的形式實現跨域。

流程總結

  1. 客戶端註冊一個回呼函式(例如 jsoncallback),並把實際產生的函式名稱(例如 jsonp1236827957501)當參數傳給伺服器。
  2. 伺服器先產生 JSON 資料。
  3. 伺服器以 JavaScript 語法把資料包成 jsonp1236827957501(資料) 的形式回傳。
  4. 瀏覽器解析並執行這段 script,資料作為參數傳入客戶端的回呼函式。

本質上這與 <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 協定本身也支援跨來源資料交換,是另一個選項。

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