2.0.0 • Published 4 years ago

cordova-plugin-archive-zip v2.0.0

Weekly downloads
13
License
Apache-2.0
Repository
github
Last release
4 years ago

cordova-plugin-archive-zip

Cordova plugin to create zip archive

Installation

cordova plugin add cordova-plugin-archive-zip

// you may also install directly from this repo cordova plugin add https://github.com/kitolog/cordova-plugin-zip-archive

Sample usage

Here is simple example of how to zip files

Create instance of Zip plugin:

var zipInstance = new window.zipArchive()

Set data consumer, error and close handlers:

zipInstance.onError = function(errorMessage) {
  // invoked after error occurs
};

Archive files

zipInstance.zip('/PATH/TO/NEW/ARCHIVE.zip',
    ['/PATH/TO/FILE1.txt',
     '/PATH/TO/FILE2.txt'
     '/PATH/TO/FILE3.txt'
     '/PATH/TO/FILE4.csv'
    ], 
    () => {
    // zip archive created
    },
    (error) => {
    // handle errors
    })

API

Event handlers

onError: (message: string) => void

Invoked when some error occurs during zip process.

on: (eventName: string, callback: function) => void

Syntax sugar for the event handlers (onTick, onStop, onError) eventName: error

Methods

zip(path, files, options, onSuccess?, onError?): void

Establishes connection with the remote host.

parametertypedescription
pathstringzip archive path
filesstring arraypath to files
optionsoptions object or nullpath to files
onSuccess() => voidSuccess callback - called after archive was created. (optional)
onError(message: string) => voidError callback - called when some error occurs during creating an archive. (optional)

Options:

parametertypedescription
maxSizefloatFile size, in Mb. Default 0 - no max size

What's new

  • 1.0.0 - initial code
  • 1.0.1 - cleared zip instances
  • 2.0.0 - added max file size and zip parts support, updated SSZipArchive version