想用 AJAX 抓一些公開 API,卻完全不想碰任何伺服器端程式碼——這聽起來像不可能的任務,因為瀏覽器的同源策略會毫不留情地攔下跨網域的請求。
舉例來說,我想取得一份天氣資料,直覺的做法是:
$.get("https://m.weather.com.cn/data/101010100.html");

這個錯誤相信大家都見過,解法也很自然:架一個自己的代理端點,或改用 JSONP。但前者意味著得動伺服器,而後者要求對方實作 callback 契約——偏偏這個 API 沒有。
這時候可以請出 Yahoo 提供的公開 JSONP 代理:
https://query.yahooapis.com/v1/public/yql
YQL 的設計允許你用類似 SQL 的語法查詢網路資源,並以 JSONP 形式回傳結果。也就是說,跨域這件事由 Yahoo 的伺服器代為完成,我們只需要寫前端。
線上範例:https://jsfiddle.net/whitewolf/4UDpf/9/
HTML 部分:
<script type="text/javascript" src="https://ajax.cdnjs.com/ajax/libs/json2/20110223/json2.js"></script> <div id="content"> </div>
JavaScript 部分:
$(function(){
$.getJSON("https://query.yahooapis.com/v1/public/yql", {
q: "select * from json where url=\"https://m.weather.com.cn/data/101010100.html\"",
format: "json"
}, function(data) {
var $content = $("#content")
if (data.query.results) {
$content.text(JSON.stringify(data.query.results));
} else {
$content.text('no such code: ' + code);
}
});
});

q 參數裡的 select * from json where url="..." 就是 YQL 的查詢語法,把目標網址塞進去即可;format: "json" 指定回傳格式。由於 $.getJSON 在偵測到跨網域時會自動改用 script 標籤注入的方式,我們不必手動處理 callback 參數。
回傳的結構固定包在 data.query.results 之下,所以取值前一定要先判空——目標網站掛掉、回傳非預期格式時,這層會是 undefined。程式中範例的 else 分支有個小瑕疵:code 變數並未定義,實用時應替換成有意義的錯誤訊息。
剩下的細節就不多說了,JSONP 的原理相信大家都清楚:動態建立 script 標籤,讓瀏覽器把跨網域資源當成自家腳本執行,藉此繞過同源限制。代價是只能發 GET、無法 proper 地處理錯誤狀態碼,因此正式環境仍建議搭配自己的後端代理,並對第三方回傳的內容做好驗證與轉義。