檔案上傳協定有好幾種,這次主要處理的是 Content-Type: multipart/form-data 這一種。
工作中的前台頁面透過 FTL 模板系統輸出,並以 SSI 方式引用。專案開發時需要產生大量靜態 SHTML 檔,我原本以為這是後端的事,沒想到進公司之後這塊工作就落到前端頭上。既然要做,就試著想:能不能用 Ajax 一次搞定?
翻 MDN 時注意到 FormData 這個物件,看起來正好能解決多檔上傳的協議問題:
https://developer.mozilla.org/en-US/docs/DOM/XMLHttpRequest/FormData
理論上一切完美,但實測時發現 File 相關的建構方式只能在 chrome 級別(也就是有特權的環境)中運行。也就是說,普通網頁裡沒辦法直接凭 URL 建出一個 File 物件,圖片上傳卡住了;一般純文字檔倒是可以靠 Blob 物件繞過去。
找了大半天,所有「URL → File」的方法都失敗。瀏覽器基於安全考量,不允許頁面自行偽造一個可上傳的檔案。
從 MDN 的 FileReader 範例開始:
https://developer.mozilla.org/en-US/docs/DOM/FileReader
範例中印出 oFREvent.target.result,得到的是這樣一串:
data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEASABIAAD/2wBDAAUDBAQEAwUEBAQFBQ...
原來是 base64 編碼後的資料。看到這種格式,第一個念頭是:Blob 是不是吃這個?於是試了:
var fd = new FormData();
fd.append('my-file', new Blob(
["data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEASABIAAD/2wBDAAUDBAQEAwUEBAQFBQ..."],
{ type: "image/jpeg" }
));
fd.append('my-file', new Blob(
["data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEASABIAAD/2wBDAAUDBAQEAwUEBAQFBQ..."],
{ type: "image/jpeg;base64" }
));
既然對方是 base64 編碼過的,那把前綴拿掉、解碼回二進位再包 Blob 呢?網上找了一段 base64 編解碼的範例套進去:
fd.append('my-file', new Blob(
[new Base64().decode('/9j/4AAQSkZJRgABAQEASABIAAD/2wBDAAUDBAQEAwUEBAQFBQ...')],
{ type: "image/jpeg" }
));
結果抓包一看,傳出去的內容與瀏覽器原生表單上傳的格式完全不同,顯然還是失敗了。
瀏覽器基於安全,檔案選擇只能由使用者手動觸發。MDN 上的官方寫法其實非常直白:
https://developer.mozilla.org/en-US/docs/DOM/XMLHttpRequest/FormData/Using_FormData_Objects
fd.append('my-file', document.querySelector(Selector).files[0]);
繞了這麼一大圈才發現,關鍵就在最後這個連結最上方——FileReader 那套 API 把我誤導了,一直以為可以在頁面層級自行造檔,結果白走了不少冤枉路。
如果確實需要在 privileged 環境中操作(例如寫成 userscript 給 Greasemonkey / Tampermonkey 使用),透過那樣的方式注入函式、取得 chrome 級別的 File 建構能力,就可以比較方便地上傳圖片了。
這篇記錄的是 2012 年前後的情況。以現今標準來說,<input type="file"> 選檔後直接 fd.append('file', input.files[0]),再搭配 XHR 的 upload.onprogress 就能取得上傳進度,是既簡單又完整的做法。若需要預覽,用 URL.createObjectURL(file) 即可;要縮圖則可用 canvas 處理。當年那些試圖凭 base64 反造 File 的嘗試,現在回頭看是走了彎路,但也因此把底層的界線摸清楚了。