2023-12-04 18:29:05 -05:00

2.6 KiB

title, layout, section
title layout section
load(data [, options]) default api

Description : Read an existing zip and merge the data in the current JSZip object at the current folder level. This technique has some limitations, see here.

Arguments

name type description
data String/ArrayBuffer/Uint8Array/Buffer the zip file
options object the options to load the zip file

Content of options :

name type default description
options.base64 boolean false set to true if the data is base64 encoded, false for binary.
options.checkCRC32 boolean false set to true if the read data should be checked against its CRC32.
options.optimizedBinaryString boolean false set to true if (and only if) the input is a string and has already been prepared with a 0xFF mask.
options.createFolders boolean false set to true to create folders in the file path automatically. Leaving it false will result in only virtual folders (i.e. folders that merely represent part of the file path) being created.

You shouldn't update the data given to this method : it is kept as it so any update will impact the stored data.

Zip features supported by this method :

  • Compression (DEFLATE supported)
  • zip with data descriptor
  • ZIP64
  • UTF8 in file name, UTF8 in file content

Zip features not (yet) supported :

  • password protected zip
  • multi-volume zip

Returns : The current JSZip object.

Throws : An exception if the loaded data is not valid zip data or if it uses features (multi volume, password protected, etc).

Example

var zip = new JSZip();
zip.load(zipDataFromXHR);
require("fs").readFile("hello.zip", function (err, data) {
  if (err) throw err;
  var zip = new JSZip();
  zip.load(data);
}

Using sub folders :

var zip = new JSZip();
zip.folder("subfolder").load(data);
// the content of data will be loaded in subfolder/