Lz4.js

Lz4.js is an implementation of Lz4 designed to be used in web browsers. It contains no dependencies on external libraries or Node.JS, though it is organized as a set of CommonJS modules. It is recommended to use Browserify or WebPack to bundle this for the web browser.

Installation

npm install lz4js

Usage

1var lz4 = require("lz4js");
2var fs = require("fs");
3
4// Compress 128 bytes of zero.
5var compressed = lz4.compress(new Array(128));
6
7// Decompress.
8var decompressed = lz4.decompress(compressed);
9
10// Compress file.bin to file.lz4.
11var data = fs.readFileSync("file.bin");
12compressed = Buffer.from(lz4.compress(data));
13fs.writeFileSync('file.lz4', compressed);

Note: The high-level compress and decompress functions deal with framed Lz4 data and do not support raw block data nor legacy Lz4 blocks.

API

The API accepts either Arrays or Uint8Arrays. Arrays are expected to be arrays of unsigned 8-bit values. The API will return Uint8Arrays if the browser supports them, or Arrays otherwise.

• compress(buffer: Array, maxSize: Number): Array

  Compresses a buffer using Lz4. maxSize sets bounds on the output length; it is recommended to not specify this unless you know what you're doing. Any unused buffer data will be sliced before the buffer is returned.

• decompress(buffer: Array, maxSize: Number): Array

  Decompresses a buffer using Lz4. maxSize sets bounds on the output length; if you know the output length, this will reduce memory usage somewhat. Any unused buffer data will be sliced before the buffer is returned.