正如 Evert 所说,我应该首先检查文档https://stuk.github.io/jszip/documentation/contributing.html中的构建说明。
很明显,第一个需要 git 并进行本地克隆。然后需要设置 grunt 命令行,它需要 npm,它是 nodejs 自带的。一旦 grunt 运行,还有其他依赖项需要 npm install-ed。这是通常的小事关闭并且不起作用,但是足够的谷歌搜索和蛮力重试以完成它。
现在 jszip/lib/index.js 包含最终导出的资源。就是那个 JSZip 对象。所以只是为了玩内部的东西,我可以将这些添加到 JSZip 对象中,例如,它已经包含:
JSZip.external = require("./external");
module.exports = JSZip;
所以我们可以很容易地添加我们想要玩的其他资源:
JSZip.flate = require("./flate");
JSZip.DataWorker = require('./stream/DataWorker');
JSZip.DataLengthProbe = require('./stream/DataLengthProbe');
JSZip.Crc32Probe = require('./stream/Crc32Probe');
JSZip.StreamHelper = require('./stream/StreamHelper');
JSZip.pako = require("pako");
现在,我可以在 Chrome 调试器中创建概念证明:
(new JSZip.StreamHelper(
(new JSZip.DataWorker(Promise.resolve("Hello World! Hello World! Hello World! Hello World! Hello World! Hello World!")))
.pipe(new JSZip.DataLengthProbe("uncompressedSize"))
.pipe(new JSZip.Crc32Probe())
.pipe(JSZip.flate.compressWorker({}))
.pipe(new JSZip.DataLengthProbe("compressedSize"))
.on("end", function(event) { console.log("onEnd: ", this.streamInfo) }),
"uint8array", "")
).accumulate(function(data) { console.log("acc: ", data); })
.then(function(data) { console.log("then: ", data); })
这有效。我一直在为自己制作一个带有 gzip 标头和预告片的 GZipFileStream,正确地创建了所有内容。我将 jszip/lib/generate/GZipFileWorker.js 放入如下:
'use strict';
var external = require('../external');
var utils = require('../utils');
var flate = require('../flate');
var GenericWorker = require('../stream/GenericWorker');
var DataWorker = require('../stream/DataWorker');
var StreamHelper = require('../stream/StreamHelper');
var DataLengthProbe = require('../stream/DataLengthProbe');
var Crc32Probe = require('../stream/Crc32Probe');
function GZipFileWorker() {
GenericWorker.call(this, "GZipFileWorker");
this.virgin = true;
}
utils.inherits(GZipFileWorker, GenericWorker);
GZipFileWorker.prototype.processChunk = function(chunk) {
if(this.virgin) {
this.virgin = false;
var headerBuffer = new ArrayBuffer(10);
var headerView = new DataView(headerBuffer);
headerView.setUint16(0, 0x8b1f, true); // GZip magic
headerView.setUint8(2, 0x08); // compression algorithm DEFLATE
headerView.setUint8(3, 0x00); // flags
// bit 0 FTEXT
// bit 1 FHCRC
// bit 2 FEXTRA
// bit 3 FNAME
// bit 4 FCOMMENT
headerView.setUint32(4, (new Date()).getTime()/1000>>>0, true);
headerView.setUint8(8, 0x00); // no extension headers
headerView.setUint8(9, 0x03); // OS type UNIX
this.push({data: new Uint8Array(headerBuffer)});
}
this.push(chunk);
};
GZipFileWorker.prototype.flush = function() {
var trailerBuffer = new ArrayBuffer(8);
var trailerView = new DataView(trailerBuffer);
trailerView.setUint32(0, this.streamInfo["crc32"]>>>0, true);
trailerView.setUint32(4, this.streamInfo["originalSize"]>>>0 & 0xffffffff, true);
this.push({data: new Uint8Array(trailerBuffer)});
};
exports.gzip = function(data, inputFormat, outputFormat, compressionOptions, onUpdate) {
var mimeType = data.contentType || data.mimeType || "";
if(! (data instanceof GenericWorker)) {
inputFormat = (inputFormat || "").toLowerCase();
data = new DataWorker(
utils.prepareContent(data.name || "gzip source",
data,
inputFormat !== "string",
inputFormat === "binarystring",
inputFormat === "base64"));
}
return new StreamHelper(
data
.pipe(new DataLengthProbe("originalSize"))
.pipe(new Crc32Probe())
.pipe(flate.compressWorker( compressionOptions || {} ))
.pipe(new GZipFileWorker()),
outputFormat.toLowerCase(), mimeType).accumulate(onUpdate);
};
在 jszip/lib/index.js 我只需要这个:
var gzip = require("./generate/GZipFileWorker");
JSZip.gzip = gzip.gzip;
这就像这样:
JSZip.gzip("Hello World! Hello World! Hello World! Hello World! Hello World! Hello World!", "string", "base64", {level: 3}).then(function(result) { console.log(result); })
我可以将结果粘贴到这样的 UNIX 管道中:
$ echo -n "H4sIAOyR/VsAA/NIzcnJVwjPL8pJUVTwoJADAPCORolNAAAA" |base64 -d |zcat
它正确返回
Hello World! Hello World! Hello World! Hello World! Hello World! Hello World!
它也可以与文件一起使用:
JSZip.gzip(file, "", "Blob").then(function(blob) {
xhr.setRequestProperty("Content-encoding", "gzip");
xhr.send(blob);
})
我可以将 blob 发送到我的网络服务器。我已经检查过大文件确实是按块处理的。
我唯一不喜欢的是最终的 blob 仍然组装成一个大的 Blob,所以我假设它将所有压缩数据保存在内存中。如果那个 Blow 是那个 Worker 管道的一个端点会更好,这样当 xhr.send 从 Blob 中逐块抓取数据时,它才会消耗来自 Worker 管道的块。但是,鉴于它只包含压缩内容,并且可能(至少对我而言)大文件是不需要 gzip 压缩的多媒体文件,因此影响会大大减轻。
我没有编写 gunzip 函数,因为坦率地说,我不需要,也不想制作一个无法正确解析 gzip 标头中的扩展标头的函数。一旦我将压缩内容上传到服务器(在我的情况下为 S3),当我再次获取它时,我假设浏览器会为我解压缩。我还没有检查过。如果它成为一个问题,我会回来更多地编辑这个答案。
这是我在 github 上的 fork:https ://github.com/gschadow/jszip ,拉取请求已经输入。