tree: e859b467d691ca83df717787cb55fbf74e34b0c3 [path history] [tgz]
  1. .idea/
  2. MIT-LICENSE.txt
  3. README.md
  4. adm-zip.js
  5. headers/
  6. methods/
  7. package.json
  8. test/
  9. util/
  10. zipEntry.js
  11. zipFile.js
node_modules/adm-zip/README.md

ADM-ZIP for NodeJS

ADM-ZIP is a pure JavaScript implementation for zip data compression for NodeJS.

Installation

With npm do:

$ npm install adm-zip

What is it good for?

The library allows you to:

  • decompress zip files directly to disk or in memory buffers
  • compress files and store them to disk in .zip format or in compressed buffers
  • update content of/add new/delete files from an existing .zip

Dependencies

There are no other nodeJS libraries that ADM-ZIP is dependent of

Examples

Basic usage


var AdmZip = require('adm-zip'); // reading archives var zip = new AdmZip("./my_file.zip"); var zipEntries = zip.getEntries(); // an array of ZipEntry records zipEntries.forEach(function(zipEntry) { console.log(zipEntry.toString()); // outputs zip entries information if (zipEntry.entryName == "my_file.txt") { console.log(zipEntry.data.toString('utf8')); } }); // outputs the content of some_folder/my_file.txt console.log(zip.readAsText("some_folder/my_file.txt")); // extracts the specified file to the specified location zip.extractEntryTo(/*entry name*/"some_folder/my_file.txt", /*target path*/"/home/me/tempfolder", /*maintainEntryPath*/false, /*overwrite*/true); // extracts everything zip.extractAllTo(/*target path*/"/home/me/zipcontent/", /*overwrite*/true); // creating archives var zip = new AdmZip(); // add file directly zip.addFile("test.txt", new Buffer("inner content of the file"), "entry comment goes here"); // add local file zip.addLocalFile("/home/me/some_picture.png"); // get everything as a buffer var willSendthis = zip.toBuffer(); // or write everything to disk zip.writeZip(/*target file name*/"/home/me/files.zip"); // ... more examples in the wiki

For more detailed information please check out the wiki.

build status