It's a utility of zlib, gzip and zip format binary data.
chrome, firefox, IE10, safari, opera.
If the api is written as foo({a, b, c}), you can call it as below.
foo(1, 2, 3);
foo({
a: 1,
b: 2,
c: 3
});
jsziptools uses ES6 Promises and add spread
method.
- @param {function} onFulfillment
- @param {function} onRejection - optional
- @return {Promise}
It spreads a Array argument in a onFulfillment
callback.
// in ES6 Promises then
Promise.all([1, 2, 3]).then(function (args) {
var one = args[0], two = args[1], three = args[2];
});
// in Promise.prototype.spread
Promise.all([1, 2, 3]).spread(function (one, two, three) {
// ...
});
- @param {ArrayBuffer|Uint8Array|Array|string} buffer
- @return {Uint8Array}
- @param {Blob} blob
- @return {Promise}
jz.utils.readFileAsArrayBuffer(blob)
.then(function (buffer) {
// ...
});
- @param {Blob} blob
- @param {string} encoding - optional (default is
"UTF-8"
) - @return {Promise}
- @param {Blob} blob
- @return {Promise}
- @param {Blob} blob
- @return {Promise}
- @param {Uint8Array|ArrayBuffer|Array|string} buffer
- @return {Promise}
jz.utils.bytesToString(bytes)
.then(function (str) {
// ...
});
- @param {Array.<Uint8Array|ArrayBuffer>} buffers
- @return {Uint8Array}
var concated = jz.utils.concatBytes([bytes1, bytes2]);
// or
var concated = jz.utils.concatBytes(bytes1, bytes2);
It loads files as Uint8Array
.
- @param {Array.<string>} urls
- @return {Promise}
jz.utils.load(['foo.png', 'bar.jpg'])
.spread(function (foo, bar) {
// ...
});
// or
jz.utils.load('foo.png', 'bar.jpg')
.spread(function (foo, bar) {
// ...
});
- @param {Uint8Array|ArrayBuffer} buffer
- @param {number} level - optional (default is
6
, range is 0-9) - @param {number} chunkSize - optional (default is
0x8000
) - @return {Uint8Array}
- @param {Uint8Array|ArrayBuffer} buffer
- @param {number} chunkSize - optional (default is
0x8000
) - @return {Uint8Array}
- @param {Uint8Array|ArrayBuffer} buffer
- @return {number}
- @param {Uint8Array|ArrayBuffer} buffer
- @param {number}
- @return {number}
- @param {Uint8Array|ArrayBuffer} buffer
- @param {function(chunk: Uint8Array)} streamFn
- @param {number} level - optional (default is
6
) - @param {boolean} shareMemory - optional (default is
false
) - @param {number} chunkSize - optional (default is
0x8000
)
jz.stream.algos.deflate({
buffer: buffer,
streamFn: function (chunk) {
// ...
},
shareMemory: false
});
- @param {Uint8Array|ArrayBuffer} buffer
- @param {function(chunk: Uint8Array)} streamFn
- @param {boolean} shareMemory - optional (default is
false
) - @param {number} chunkSize - optional (default is
0x8000
)
- @param {Uint8Array|ArrayBuffer} buffer
- @param {number} level - optional (default is
6
) - @param {number} chunkSize - optional (default is
0x8000
) - @return {Uint8Array}
- @param {Uint8Array|ArrayBuffer} buffer
- @param {number} chunkSize - optional (default is
0x8000
) - @return {Uint8Array}
- @param {Uint8Array|ArrayBuffer} buffer
- @param {function(chunk: Uint8Array)} streamFn
- @param {number} level - optional (default is
6
) - @param {boolean} shareMemory - optional (default is
false
) - @param {number} chunkSize - optional (default is
0x8000
)
- @param {Uint8Array|ArrayBuffer} buffer
- @param {function(chunk: Uint8Array)} streamFn
- @param {boolean} shareMemory - optional (default is
false
) - @param {number} chunkSize - optional (default is
0x8000
)
- @param {Uint8Array|ArrayBuffer} buffer
- @param {number} level - optional (default is
6
) - @param {number} chunkSize - optional (default is
0x8000
) - @return {Uint8Array}
- @param {Uint8Array|ArrayBuffer} buffer
- @param {number} chunkSize - optional (default is
0x8000
) - @return {Uint8Array}
- @param {Uint8Array|ArrayBuffer} buffer
- @param {function(chunk: Uint8Array)} streamFn
- @param {number} level - optional (default is
6
) - @param {boolean} shareMemory - optional (default is
false
) - @param {number} chunkSize - optional (default is
0x8000
) - @param {string} fname - optional
- @param {string} fcomment - optional
- @param {Uint8Array|ArrayBuffer} buffer
- @param {function(chunk: Uint8Array)} streamFn
- @param {boolean} shareMemory - optional (default is
false
) - @param {number} chunkSize - optional (default is
0x8000
)
- @param {Array.} files
- @param {number} level - optional (default is
6
) - @param {number} chunkSize - optional (default is
0x8000
) - @return {Promise}
- @param {Uint8Array|ArrayBuffer|Blob} buffer
- @param {string} encoding - optional (default is
"UTF-8"
) - @param {number} chunkSize - optional (default is
0x8000
) - @return {Promise}
- @param {Array} files
- @param {function(chunk: Uint8Array)} streamFn
- @param {number} level - optional (default is
6
) - @param {boolean} shareMemory - optional (default is
false
) - @param {number} chunkSize - optional (default is
0x8000
) - @return {Promise}
- @return {Array.<string>}
- @param {string} filename
- @return {Promise}
- @param {string} filename
- @return {Promise}
- @param {string} filename
- @param {string} encoding
- @return {Promise}
- @param {string} filename
- @return {Promise}
- @param {string} filename
- @return {Promise}
- @param {string} filename
- @return {ArrayBuffer}
- @param {string} filename
- @return {Blob}
- @param {string} filename
- @param {string} encoding
- @return {string}
- @param {string} filename
- @return {string}
- @param {string} filename
- @return {string}
- @param {boolean} shareMemory - optional (default is
false
) - @param {number} chunkSize - optional (default is
0x8000
) - @param {string} name
- @param {function} callback
- @return {jz.zip.ZipArchiveWriter} this
- @param {string} path
- @param {Uint8Array} buffer
- @param {number} level - optional (default is
6
) - @return {jz.zip.ZipArchiveWriter} this
- @param {string} path
- @return {jz.zip.ZipArchiveWriter} this
- @param {string} path
- @param {Uint8Array} buffer
- @param {number} level - optional (default is
6
) - @return {jz.zip.ZipArchiveWriter} this
var files = [
{name: "foo", dir: [ // folder
{name: "hello.txt", buffer: "Hello World!"}, // string
{name: "bar.js", buffer: buffer}, // ArrayBuffer
{name: "hoge.mp3", url: "audiodata/hoge.mp3"} // xhr
]}
];
jz.zip.pack({
files: files,
level: 5
})
.then(function (buffer) {
// buffer is Uint8Array
});
// You cat set compression level to each files.
var files = [
{name: "mimetype", buffer: "application/epub+zip", level: 0}, //string
{name: "META-INF", dir: [ //folder
{name: "container.xml", buffer: buffer, level: 0}, //ArrayBuffer
]},
{name: "package.opf", url: "package.opf", level: 6},
{name: "foo.xhtml", url: "foo.xhtml", level: 9} //xhr
];
jz.zip.pack(files)
.then(function (buffer) {
// ...
});
jz.zip.unpack({
buffer: buffer,
encoding: 'Shift_JIS' // encoding of filenames
})
.then(function (reader) {
// reader is ZipArchiveReader. See below.
// get file names.
reader.getFileNames();
reader.readFileAsText(reader.getFileNames[0])
.then(function (text) {
// ...
});
});
jz.stream.zip.pack({
files: files,
streamFn: function (chunk) {
// ...
}
})
.then(function () {
// no args
});
It gets filenames in the zip archive.
Low level zip archive writer.
var writer = new jz.zip.ZipArchiveWriter({shareMemory: true, chunkSize: 0xf000});
writer
.on('data', function(chunk) {
// chunk is Uint8Array.
})
.on('end', function() {
// ...
});
.write('foo/bar/baz.txt', buffer)
.write('a.mp3', mp3Buff)
.writeEnd();
Write the file. Directories are created automatically.
writer.write('a/b/c/d/foo.txt', buffer, 7);
writer.writeDir('foo/');
// or
writer.writeDir('bar');
writer.writeDir('a/');
writer.writeDir('a/b/');
writer.writeDir('a/b/c/');
writer.writeFile('a/b/c/foo.txt', buffer, 7);
Write central directory headers and the end central dirctory header.
writer.writeEnd();