用 Node.js 寫一個最簡單的 API,再讓前端頁面透過 Ajax 去抓,是理解「前後端如何對接」最直接的練習。這個範例刻意把伺服器開在 1337 埠,而頁面從另一個埠提供,因此會踩到跨域——正好可以把解法一起講清楚。
靜態頁面 index.html(務必放在伺服器環境下執行;Windows 使用者可以直接用 IIS 站台,或利用編輯器內建的靜態伺服器):
<!DOCTYPE html>
<html>
<head lang="en">
<meta charset="UTF-8">
<title>node 中的 ajax 請求(html5 頁面)</title>
<script type="text/javascript">
function GetData(){
var xhr = new XMLHttpRequest();
xhr.open("GET", "https://localhost:1337/", true);
xhr.onreadystatechange = function(){
if (xhr.readyState == 4) {
if (xhr.status == 200) {
document.getElementById("res").innerHTML = xhr.responseText;
}
}
};
xhr.send(null);
}
</script>
</head>
<body>
<input type="button" value="獲取數據" onclick="GetData()" />
<div id="res"></div>
</body>
</html>
var http = require("http");
var server = http.createServer(function (req, res) {
if (req.url !== "/favicon.ico") {
res.writeHead(200, {
"Content-Type": "text/plain",
"Access-Control-Allow-Origin": "https://localhost"
});
res.write("你好啊!");
}
res.end();
});
server.listen(1337, "localhost", function () {
console.log("開始監聽...");
});
關鍵就在 Access-Control-Allow-Origin 這個回應標頭:它明確告知瀏覽器「允許哪個來源讀取我的回應」。若省略埠號,則該網域下的任何埠都獲准。
先啟動服務:
node server.js
再開啟靜態頁面:

點擊「獲取數據」按鈕:

以 WebStorm 8.0 為例,啟動頁面後網址會類似 https://localhost:63342/,埠號是 63342。這時只要把服務端的白名單改成對應來源即可:
var http = require("http");
var server = http.createServer(function (req, res) {
if (req.url !== "/favicon.ico") {
res.writeHead(200, {
"Content-Type": "text/plain",
"Access-Control-Allow-Origin": "https://localhost:63342"
});
res.write("你好啊!");
}
res.end();
});
server.listen(1337, "localhost", function () {
console.log("開始監聽...");
});
重新執行 demo,效果相同。
var http = require("http");
var server = http.createServer(function (req, res) {
if (req.url !== "/favicon.ico") {
res.setHeader("Content-Type", "text/plain");
res.setHeader("Access-Control-Allow-Origin", "https://localhost:63342");
res.write("你好啊!");
}
res.end();
});
server.listen(1337, "localhost", function () {
console.log("開始監聽...");
});
仔細的人會發現:用 setHeader 時沒有地方寫狀態碼。狀態碼要另外指定:
res.statusCode = 200;
順帶一提,Node 預設會送出 Date 標頭:

若不希望暴露伺服器時間,可以關掉:
var http = require("http");
var server = http.createServer(function (req, res) {
if (req.url !== "/favicon.ico") {
res.statusCode = 200;
res.sendDate = false;
res.setHeader("Content-Type", "text/plain");
res.setHeader("Access-Control-Allow-Origin", "https://localhost:63342");
res.write("你好啊!");
}
res.end();
});
server.listen(1337, "localhost", function () {
console.log("開始監聽...");
});

狀態碼設好了,日期資訊也一併隱藏。
res.getHeader(name):讀取已設定的回應標頭res.removeHeader(name):刪除標頭,必須在 write 送出資料之前呼叫res.headersSent:布爾值,回應標頭已送出為 true,否則為 falsevar http = require("http");
var server = http.createServer(function (req, res) {
if (req.url !== "/favicon.ico") {
console.log(res.headersSent ? "響應頭已發送" : "響應頭未發送");
res.writeHead(200, {
"Content-Type": "text/plain",
"Access-Control-Allow-Origin": "https://localhost:63342"
});
console.log(res.headersSent ? "響應頭已發送" : "響應頭未發送");
res.write("你好啊!");
}
res.end();
});
server.listen(1337, "localhost", function () {
console.log("開始監聽...");
});
執行結果:

可以看見第一次輸出是「未發送」,writeHead 之後就變成「已發送」。
res.write() 用來送出資料,但它其實會回傳一個布爾值,反映的是背壓(backpressure)狀態:
true;false。想驗證的話,調整要輸出的檔案大小再觀察即可。
認真處理時,收到 false 就該等待 drain 事件再繼續寫入,否則大量資料會持續堆積在記憶體裡。
一個可用的 Node + Ajax 最小範例就到這裡。跨域標頭、狀態碼、標頭操作、背壓判斷,這四件事理解之後,再往複雜的情境推進會順手很多。