DIV CSS 佈局教程網

用 jQuery.ajax 上傳檔案表單時會踩到的兩個參數陷阱
編輯:JQuery入門技巧     

幫人看程式碼時遇到一個小狀況:用 jQuery 上傳帶有檔案的表單一直失敗。原因不難找,但文件散在兩處,記錄下來以後翻閱方便。

問題一:processData 必須設為 false

上傳檔案時我們會用 FormData 包裝表單資料。但 jQuery 預設會對傳進 data 的內容做序列化處理,而 FormData 沒辦法被這樣加工,於是就丟出 Illegal invocation。

解法是在 $.ajax 的參數裡明確關掉這個行為:

processData: false

官方文件的原文說明如下:

問題二:Content-Type 不能寫死

預設情況下,jQuery 送出的請求頭是 application/x-www-form-urlencoded; charset=UTF-8,也就是我們熟悉的 a=A&b=B 這種查詢字串格式。檔案上傳用的是 multipart/form-data,格式完全不同,硬套就會出錯。

更關鍵的是:multipart 請求的 Content-Type 開頭帶有一個 boundary 參數,瀏覽器會依實際資料內容自動產生。如果我們自己寫死這個標頭,boundary 就會跟 body 裡的分隔符號對不上,伺服器一樣解析不出來。所以正確做法是加上 contentType: false,讓瀏覽器自行決定:

contentType: false

若是 jQuery 版本低於 1.6(不支援設成 false),則得手動指定為 multipart/form-data。相關說明見文件:

完整寫法

var formData = new FormData();
formData.append("file", $("#fileInput")[0].files[0]);
formData.append("name", $("#nameInput").val());

$.ajax({
    url: "/api/upload",
    type: "POST",
    data: formData,
    processData: false,   // 別讓 jQuery 加工 FormData
    contentType: false,   // 讓瀏覽器自動補上 boundary
    success: function (res) { console.log(res); },
    error: function (err) { console.error(err); }
});

以前我習慣直接用原生的 XMLHttpRequest,什麼標頭都自己控制,所以從沒碰到這兩個坑。既然遇到了就補起來。一句話總結:用 FormData 上傳,processData 與 contentType 都要設 false。

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