bodyParser 負責解析客戶端請求 body 中的內容,內部涵蓋 JSON 解析、URL 編碼解析,以及檔案上傳的處理。
下面用一個檔案上傳的完整例子來看它怎麼運作。
建立 1.html:
<!DOCTYPE html>
<html>
<head lang="en">
<meta charset="UTF-8">
<title>向服務器上傳文件</title>
<script type="text/javascript">
function uploadFile(){
var formData=new FormData();
var files=document.getElementById("files").files;
var file=files[0];
formData.append("myfile",file);
var xhr=new XMLHttpRequest();
xhr.open("post","index.html",true);
xhr.onload= function (e) {
if(this.status==200)
document.getElementById("result").innerHTML=this.response;
};
xhr.send(formData);
}
</script>
</head>
<body>
請選擇文件:<input type="file" id="files" name="file" />
<input type="button" value="上傳文件" onclick="uploadFile();" />
<div id="result"></div>
</body>
</html>
這裡用到的 XMLHttpRequest 與 FormData 都是 HTML5 的東西,不是本文重點。關鍵在於 FormData 能把使用者挑選的檔案封裝好,直接 POST 到伺服器。
而在伺服器端,一旦掛上 app.use(express.bodyParser()),代表請求的 http.IncomingMessage(也就是 req 物件)就多了一個 files 屬性——上傳的檔案會從這裡取出。
server.js:
var express=require("express");
var fs=require("fs");
var app=express();
app.use(express.bodyParser());
app.get("/index.html", function (req,res) {
res.sendfile(__dirname+"/1.html");
});
app.post("/index.html", function (req,res) {
var file=req.files.myfile;
fs.readFile(file.path, function (err,data) {
if(err) res.send("讀文件操作失敗");
else{
fs.writeFile(file.name,data, function (err) {
if(err) res.send("寫文件操作失敗.");
else res.send("文件上傳成功");
})
}
});
});
app.listen(1337,"127.0.0.1", function () {
console.log("開始監聽");
});
值得注意 req.files.myfile 這個 myfile——它對應前端 formData.append("myfile", file) 裡的第一個參數,兩邊名稱必須一致。而 file 物件上帶著 path(暫存路徑)與 name(原始檔名),所以流程是先從暫存位置讀出來,再以原名寫進專案目錄。
啟動伺服器、開啟瀏覽器:

選擇要上傳的檔案:

按下上傳,瀏覽器端出現「上傳成功」字樣:
伺服器端也多出了對應的檔案:

除了檔案,bodyParser 同時也處理客戶端以 AJAX 提交的 JSON 資料與 URL 編碼表單,這兩種在一般 CRUD 場景裡用得更頻繁。