Node.js 有個很討人喜歡的特點:免安裝,把執行檔複製過去就能跑,環境變數甚至可以只在當前命令列視窗設定,馬上就能開始實驗。搭配 HTML 端的 Ajax 請求,還能跨伺服器、甚至跨網域取得資料;而資料格式可以是 JSON、XML 或純二進位,幾乎任何平台都能對接。
先說明一下限制:公司電腦屬於網域管理,權限很低,不能安裝任何軟體、不能改系統設定、也不能用隨身碟。因此我準備的是 Node.js 的免安裝版本,只在當前命令列視窗內生效;既然架不了網站伺服器,就乾脆在 D 槽建一個 HTML 檔,直接雙擊用瀏覽器打開。
建立 app.js:
var http = require("http");
var fs = require("fs");
var str = '{"id":"123","name":"jack","arg":11111}';
function onRequest(request, response){
console.log("Request received.");
// 關鍵:允許跨來源請求
response.writeHead(200, {
"Content-Type": 'text/plain',
'charset': 'utf-8',
'Access-Control-Allow-Origin': '*',
'Access-Control-Allow-Methods': 'PUT,POST,GET,DELETE,OPTIONS'
});
// 若要回傳 JSON 標頭,改用下面這行
// response.writeHead(200, {"Content-Type":'application/json',
// 'Access-Control-Allow-Origin':'*',
// 'Access-Control-Allow-Methods':'PUT,POST,GET,DELETE,OPTIONS'});
str = fs.readFileSync('data.txt');
response.write(str);
response.end();
}
http.createServer(onRequest).listen(8888);
console.log("Server has started. port on 8888\n");
console.log("test data: " + str.toString());
data.txt 要放在與 app.js 相同的目錄,內容是一段 JSON:
{"id":"123","name":"jack","arg":321,"remark":"test data"}
用 node app.js 啟動後,HTML 就能透過 Ajax 取得資料了。這裡的 Access-Control-Allow-Origin: * 是跨域能成功的前提,少了它瀏覽器會直接攔下回應。
建立 aaa.html:
<!DOCTYPE html>
<html>
<head>
<title>Node JS 實例</title>
<script src="jquery-1.4.4.min.js"></script>
<script>
// 完整版 $.ajax,適合需要客製錯誤處理的場合
/*
$.ajax({
url: "https://127.0.0.1:8888/",
type: "GET",
dataType: "binary",
error: function(XMLHttpRequest, textStatus, errorThrown){
alert("error message : " + errorThrown.toString());
},
success: function(data){
$("#feeds").html(data);
var dataObj = eval('(' + data + ')');
$("#id").html("編號:" + dataObj.id);
$("#name").html("姓名:" + dataObj.name);
$("#arg").html("年齡:" + dataObj.arg);
$("span").html(dataObj.remark);
}
});
*/
// 簡潔版 $.get
$.get("https://127.0.0.1:8888/" + new Date().getTime(), function(data){
$("#feeds").html(data);
var dataObj = eval('(' + data + ')');
$("#id").html("編號:" + dataObj.id);
$("#name").html("姓名:" + dataObj.name);
$("#arg").html("年齡:" + dataObj.arg);
$("span").html(dataObj.remark);
});
</script>
</head>
<body>
<div id="feeds"></div>
<div id="id"></div>
<div id="name"></div>
<div id="arg"></div>
<span></span>
</body>
</html>
URL 後面接上 new Date().getTime() 是一個實用的小技巧:為每次請求附上不重複的查詢參數,避開瀏覽器快取,確保拿到的永遠是最新資料。jQuery 檔請自行下載並放在同一個目錄下。
本機與公司內網都測試通過,頁面輸出如下:
{"id":"123","name":"jack","arg":32100, "remark":"test data"}
編號:123
姓名:jack
年齡:32100
test data
我試過 jQuery 1.8.3 與 2.1.4 都會報錯,推測是對這種回應型態的處理有差異;改用 1.4.4 就能正常運作。其他版本我沒有逐一驗證。這個現象提醒我們:老舊的程式碼若依賴特定版本的行為,升級前一定要實際測一遍。
另外補充一點現代的建議:範例中用 eval 把字串轉成物件,在教學情境沒問題,但正式專案請改用 JSON.parse(),並在伺服器端明確回傳 application/json 標頭,讓 jQuery 自動解析。同時,正式環境也不建議把 Access-Control-Allow-Origin 設為 *,應改為列出可信的來源網域。
以上流程我都在本機實測過,重點是「Node.js 起一個極簡伺服器 + 加上 CORS 標頭 + 前端用 Ajax 取用」這條路徑,非常適合快速驗證想法。