222 lines
9.2 KiB
JavaScript
222 lines
9.2 KiB
JavaScript
'use strict';
|
|
var StringReader = require('./stringReader');
|
|
var NodeBufferReader = require('./nodeBufferReader');
|
|
var Uint8ArrayReader = require('./uint8ArrayReader');
|
|
var utils = require('./utils');
|
|
var sig = require('./signature');
|
|
var ZipEntry = require('./zipEntry');
|
|
var support = require('./support');
|
|
var jszipProto = require('./object');
|
|
// class ZipEntries {{{
|
|
/**
|
|
* All the entries in the zip file.
|
|
* @constructor
|
|
* @param {String|ArrayBuffer|Uint8Array} data the binary stream to load.
|
|
* @param {Object} loadOptions Options for loading the stream.
|
|
*/
|
|
function ZipEntries(data, loadOptions) {
|
|
this.files = [];
|
|
this.loadOptions = loadOptions;
|
|
if (data) {
|
|
this.load(data);
|
|
}
|
|
}
|
|
ZipEntries.prototype = {
|
|
/**
|
|
* Check that the reader is on the speficied signature.
|
|
* @param {string} expectedSignature the expected signature.
|
|
* @throws {Error} if it is an other signature.
|
|
*/
|
|
checkSignature: function(expectedSignature) {
|
|
var signature = this.reader.readString(4);
|
|
if (signature !== expectedSignature) {
|
|
throw new Error("Corrupted zip or bug : unexpected signature " + "(" + utils.pretty(signature) + ", expected " + utils.pretty(expectedSignature) + ")");
|
|
}
|
|
},
|
|
/**
|
|
* Read the end of the central directory.
|
|
*/
|
|
readBlockEndOfCentral: function() {
|
|
this.diskNumber = this.reader.readInt(2);
|
|
this.diskWithCentralDirStart = this.reader.readInt(2);
|
|
this.centralDirRecordsOnThisDisk = this.reader.readInt(2);
|
|
this.centralDirRecords = this.reader.readInt(2);
|
|
this.centralDirSize = this.reader.readInt(4);
|
|
this.centralDirOffset = this.reader.readInt(4);
|
|
|
|
this.zipCommentLength = this.reader.readInt(2);
|
|
// warning : the encoding depends of the system locale
|
|
// On a linux machine with LANG=en_US.utf8, this field is utf8 encoded.
|
|
// On a windows machine, this field is encoded with the localized windows code page.
|
|
this.zipComment = this.reader.readString(this.zipCommentLength);
|
|
// To get consistent behavior with the generation part, we will assume that
|
|
// this is utf8 encoded.
|
|
this.zipComment = jszipProto.utf8decode(this.zipComment);
|
|
},
|
|
/**
|
|
* Read the end of the Zip 64 central directory.
|
|
* Not merged with the method readEndOfCentral :
|
|
* The end of central can coexist with its Zip64 brother,
|
|
* I don't want to read the wrong number of bytes !
|
|
*/
|
|
readBlockZip64EndOfCentral: function() {
|
|
this.zip64EndOfCentralSize = this.reader.readInt(8);
|
|
this.versionMadeBy = this.reader.readString(2);
|
|
this.versionNeeded = this.reader.readInt(2);
|
|
this.diskNumber = this.reader.readInt(4);
|
|
this.diskWithCentralDirStart = this.reader.readInt(4);
|
|
this.centralDirRecordsOnThisDisk = this.reader.readInt(8);
|
|
this.centralDirRecords = this.reader.readInt(8);
|
|
this.centralDirSize = this.reader.readInt(8);
|
|
this.centralDirOffset = this.reader.readInt(8);
|
|
|
|
this.zip64ExtensibleData = {};
|
|
var extraDataSize = this.zip64EndOfCentralSize - 44,
|
|
index = 0,
|
|
extraFieldId,
|
|
extraFieldLength,
|
|
extraFieldValue;
|
|
while (index < extraDataSize) {
|
|
extraFieldId = this.reader.readInt(2);
|
|
extraFieldLength = this.reader.readInt(4);
|
|
extraFieldValue = this.reader.readString(extraFieldLength);
|
|
this.zip64ExtensibleData[extraFieldId] = {
|
|
id: extraFieldId,
|
|
length: extraFieldLength,
|
|
value: extraFieldValue
|
|
};
|
|
}
|
|
},
|
|
/**
|
|
* Read the end of the Zip 64 central directory locator.
|
|
*/
|
|
readBlockZip64EndOfCentralLocator: function() {
|
|
this.diskWithZip64CentralDirStart = this.reader.readInt(4);
|
|
this.relativeOffsetEndOfZip64CentralDir = this.reader.readInt(8);
|
|
this.disksCount = this.reader.readInt(4);
|
|
if (this.disksCount > 1) {
|
|
throw new Error("Multi-volumes zip are not supported");
|
|
}
|
|
},
|
|
/**
|
|
* Read the local files, based on the offset read in the central part.
|
|
*/
|
|
readLocalFiles: function() {
|
|
var i, file;
|
|
for (i = 0; i < this.files.length; i++) {
|
|
file = this.files[i];
|
|
this.reader.setIndex(file.localHeaderOffset);
|
|
this.checkSignature(sig.LOCAL_FILE_HEADER);
|
|
file.readLocalPart(this.reader);
|
|
file.handleUTF8();
|
|
file.processAttributes();
|
|
}
|
|
},
|
|
/**
|
|
* Read the central directory.
|
|
*/
|
|
readCentralDir: function() {
|
|
var file;
|
|
|
|
this.reader.setIndex(this.centralDirOffset);
|
|
while (this.reader.readString(4) === sig.CENTRAL_FILE_HEADER) {
|
|
file = new ZipEntry({
|
|
zip64: this.zip64
|
|
}, this.loadOptions);
|
|
file.readCentralPart(this.reader);
|
|
this.files.push(file);
|
|
}
|
|
},
|
|
/**
|
|
* Read the end of central directory.
|
|
*/
|
|
readEndOfCentral: function() {
|
|
var offset = this.reader.lastIndexOfSignature(sig.CENTRAL_DIRECTORY_END);
|
|
if (offset === -1) {
|
|
// Check if the content is a truncated zip or complete garbage.
|
|
// A "LOCAL_FILE_HEADER" is not required at the beginning (auto
|
|
// extractible zip for example) but it can give a good hint.
|
|
// If an ajax request was used without responseType, we will also
|
|
// get unreadable data.
|
|
var isGarbage = true;
|
|
try {
|
|
this.reader.setIndex(0);
|
|
this.checkSignature(sig.LOCAL_FILE_HEADER);
|
|
isGarbage = false;
|
|
} catch (e) {}
|
|
|
|
if (isGarbage) {
|
|
throw new Error("Can't find end of central directory : is this a zip file ? " +
|
|
"If it is, see http://stuk.github.io/jszip/documentation/howto/read_zip.html");
|
|
} else {
|
|
throw new Error("Corrupted zip : can't find end of central directory");
|
|
}
|
|
}
|
|
this.reader.setIndex(offset);
|
|
this.checkSignature(sig.CENTRAL_DIRECTORY_END);
|
|
this.readBlockEndOfCentral();
|
|
|
|
|
|
/* extract from the zip spec :
|
|
4) If one of the fields in the end of central directory
|
|
record is too small to hold required data, the field
|
|
should be set to -1 (0xFFFF or 0xFFFFFFFF) and the
|
|
ZIP64 format record should be created.
|
|
5) The end of central directory record and the
|
|
Zip64 end of central directory locator record must
|
|
reside on the same disk when splitting or spanning
|
|
an archive.
|
|
*/
|
|
if (this.diskNumber === utils.MAX_VALUE_16BITS || this.diskWithCentralDirStart === utils.MAX_VALUE_16BITS || this.centralDirRecordsOnThisDisk === utils.MAX_VALUE_16BITS || this.centralDirRecords === utils.MAX_VALUE_16BITS || this.centralDirSize === utils.MAX_VALUE_32BITS || this.centralDirOffset === utils.MAX_VALUE_32BITS) {
|
|
this.zip64 = true;
|
|
|
|
/*
|
|
Warning : the zip64 extension is supported, but ONLY if the 64bits integer read from
|
|
the zip file can fit into a 32bits integer. This cannot be solved : Javascript represents
|
|
all numbers as 64-bit double precision IEEE 754 floating point numbers.
|
|
So, we have 53bits for integers and bitwise operations treat everything as 32bits.
|
|
see https://developer.mozilla.org/en-US/docs/JavaScript/Reference/Operators/Bitwise_Operators
|
|
and http://www.ecma-international.org/publications/files/ECMA-ST/ECMA-262.pdf section 8.5
|
|
*/
|
|
|
|
// should look for a zip64 EOCD locator
|
|
offset = this.reader.lastIndexOfSignature(sig.ZIP64_CENTRAL_DIRECTORY_LOCATOR);
|
|
if (offset === -1) {
|
|
throw new Error("Corrupted zip : can't find the ZIP64 end of central directory locator");
|
|
}
|
|
this.reader.setIndex(offset);
|
|
this.checkSignature(sig.ZIP64_CENTRAL_DIRECTORY_LOCATOR);
|
|
this.readBlockZip64EndOfCentralLocator();
|
|
|
|
// now the zip64 EOCD record
|
|
this.reader.setIndex(this.relativeOffsetEndOfZip64CentralDir);
|
|
this.checkSignature(sig.ZIP64_CENTRAL_DIRECTORY_END);
|
|
this.readBlockZip64EndOfCentral();
|
|
}
|
|
},
|
|
prepareReader: function(data) {
|
|
var type = utils.getTypeOf(data);
|
|
if (type === "string" && !support.uint8array) {
|
|
this.reader = new StringReader(data, this.loadOptions.optimizedBinaryString);
|
|
}
|
|
else if (type === "nodebuffer") {
|
|
this.reader = new NodeBufferReader(data);
|
|
}
|
|
else {
|
|
this.reader = new Uint8ArrayReader(utils.transformTo("uint8array", data));
|
|
}
|
|
},
|
|
/**
|
|
* Read a zip file and create ZipEntries.
|
|
* @param {String|ArrayBuffer|Uint8Array|Buffer} data the binary string representing a zip file.
|
|
*/
|
|
load: function(data) {
|
|
this.prepareReader(data);
|
|
this.readEndOfCentral();
|
|
this.readCentralDir();
|
|
this.readLocalFiles();
|
|
}
|
|
};
|
|
// }}} end of ZipEntries
|
|
module.exports = ZipEntries;
|