為什麼要在前端解壓 ZIP?
如果只考慮標準瀏覽器,把資料打包成壓縮檔再由伺服器送到用戶端,帶寬與傳輸時間都能省下不少——聽起來確實是個不錯的思路。
當前端程式碼量龐大、又夾帶大量圖片時,這種做法的價值就更明顯了:伺服器把 JS、CSS、JPG、PNG 等資源打包成一個 ZIP 送出,瀏覽器負責解壓;CSS 以動態方式產生後插入 DOM,JS 透過 globalEval 直接執行,圖片則把 Blob 轉成 image 流再放進頁面。
HTML5 支援讀取 Blob(二進位大型物件,File 也繼承自 Blob),並能把它轉成圖片流、文字流或其他形式,這正是瀏覽器得以處理 application/zip 的基礎。
要在瀏覽器內完成解壓,需要載入四支 JS:UnZipArchive.js 依賴 zip.js、mime-type.js 與 jQuery。以下是最小可運行的範例。
<!DOCTYPE html>
<html>
<head lang="en">
<meta charset="UTF-8">
<title></title>
<script src="https://gildas-lormeau.github.io/zip.js/demos/zip.js"></script>
<script src="https://gildas-lormeau.github.io/zip.js/demos/mime-types.js"></script>
<script src="https://apps.bdimg.com/libs/jquery/1.9.0/jquery.js"></script>
<script src="https://files.cnblogs.com/files/diligenceday/UnZipArchive.js"></script>
</head>
<body>
<h2>demo</h2>
<div><input type="file" id="file"></div>
<ul id="dir"></ul>
<script>
$("#file").change(function (e) {
var file = this.files[0];
window.un = new UnZipArchive(file);
un.getData(function () {
var arr = un.getEntries(); // 取得壓縮檔內所有檔案與資料夾
var str = "";
for (var i = 0; i < arr.length; i++) {
str += "<li onclick=download('"+arr[i]+"')>" + arr[i] + "</li>";
}
$("#dir").html(str);
});
});
var download = function (filename) { un.download(filename); };
</script>
</body>
</html>
UnZipArchive.js 是自行封裝的類別,若遇到問題歡迎隨時回饋。
完整 DEMO 與相容性說明
<!DOCTYPE html>
<html>
<head lang="en">
<meta charset="UTF-8">
<title></title>
<script src="https://gildas-lormeau.github.io/zip.js/demos/zip.js"></script>
<script src="https://gildas-lormeau.github.io/zip.js/demos/mime-types.js"></script>
<script src="https://apps.bdimg.com/libs/jquery/1.9.0/jquery.js"></script>
<style> code{ display: block; padding: 10px; background: #eee; } </style>
</head>
<body>
<div>
<h1>相容性</h1>
<div>
<p>zip.js 可在所有 Chrome 與 Firefox 上執行,Safari 6 與 IE10 以上亦可使用。</p>
<p>若要在 IE9 與 Safari 上執行,需要兩個設定:</p>
<code>1:zip.useWebWorkers == false</code>
<code>2:另外載入 https://bitbucket.org/lindenlab/llsd/raw/7d2646cd3f9b/js/typedarray.js</code>
</div>
<h2>demo</h2>
<div><input type="file" id="file"></div>
<ul id="dir"></ul>
<script>
$("#file").change(function (e) {
var file = this.files[0];
window.un = new UnZipArchive(file);
un.getData(function () {
var arr = un.getEntries();
var str = "";
for (var i = 0; i < arr.length; i++) {
str += "<li onclick=download('"+arr[i]+"')>" + arr[i] + "</li>";
}
$("#dir").html(str);
});
});
var download = function (filename) { un.download(filename); };
</script>
</div>
<script>
zip.workerScriptsPath = "https://gildas-lormeau.github.io/zip.js/demos/";
/**
* @desc 解壓縮類別
* @return UnZipArchive 的實例
*/
var UnZipArchive = function (blob) {
if (!blob) { alert("參數不正確,需要一個 Blob 型別的參數"); return; }
if (!(blob instanceof Blob)) { alert("參數不是 Blob 型別"); return; }
function noop() {};
this.entries = {};
this.zipReader = {};
var _this = this;
this.length = 0;
this.onend = noop;
this.onerror = noop;
this.onprogress = noop;
var def = this.defer = new $.Deferred(); // 建立延遲物件
zip.createReader(new zip.BlobReader(blob), function (zipReader) {
_this.zipReader = zipReader;
zipReader.getEntries(function (entries) {
_this.entries = entries;
def.resolve(); // 繼續執行佇列
});
}, this.error.bind(_this));
};
/**
* @desc 把 Blob 轉成 dataURL
*/
UnZipArchive.readBlobAsDataURL = function (blob, callback) {
var f = new FileReader();
f.onload = function (e) { callback(e.target.result); };
f.readAsDataURL(blob);
};
$.extend(UnZipArchive.prototype, {
/** @desc 取得壓縮檔中所有項目名稱 @return ArrayList */
"getEntries": function () {
var result = [];
for (var i = 0, len = this.entries.length; i < len; i++) {
result.push(this.entries[i].filename);
}
return result;
},
/** @desc 依檔名取得 Entry @return Entry */
"getEntry": function (filename) {
for (var i = 0, len = this.entries.length; i < len; i++) {
if (this.entries[i].filename === filename) {
return this.entries[i];
}
}
},
/** @desc 下載檔案 @param filename @return void */
"download": function (filename, cb, runoninit) {
var _this = this;
this.defer = this.defer.then(function () {
var def = $.Deferred();
if (!filename) return;
if (runoninit) { return runoninit(); }
var entry = _this.getEntry(filename);
if (!entry) return;
entry.getData(new zip.BlobWriter(zip.getMimeType(entry.filename)), function (data) {
if (!cb) {
UnZipArchive.readBlobAsDataURL(data, function (dataUrl) {
var downloadButton = document.createElement("a"),
URL = window.webkitURL || window.mozURL || window.URL;
downloadButton.href = dataUrl;
downloadButton.download = filename;
downloadButton.click();
def.resolve(dataUrl);
_this.onend();
});
} else {
cb(data);
def.resolve(data);
}
});
return def;
});
},
/** @desc 取得對應的 Blob;也可直接傳入解壓完成後的 callback */
"getData": function (filename, fn) {
if (typeof filename === "string") {
this.download(filename, function (blob) { fn && fn(blob); });
} else if (typeof filename === "function") {
this.download("test", null, function () { filename(); });
}
},
"error": function () {
this.onerror(this);
throw new Error("壓縮檔解壓失敗");
}
});
</script>
</body>
</html>
真正難纏的其實不是解壓本身,而是瀏覽器之間的相容性落差。