npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

node-zopfli-es

v2.0.4

Published

Bindings for Zopfli compressing lib. Compress gzip files 5% better than gzip.

Downloads

11,658

Readme

node-zopfli-es


DEPRECATED!

This library will only receive sporadic updates and new features are out of question.

ALTERNATIVES

NODEJS LEGACY (<12) (no module support)

This is a fork of node-zopfli, created to fix some security issues which have since been resolved.

Since node-zopfli is maintained again, switching back to it is advised.


NPM version Linux Build Status Windows Build Status Coverage Status

Node.js bindings for Zopfli compression library. Compress gzip files 5% better compared to gzip.

It is considerably slower than gzip (~100x) so you may want to use it only for static content and cached resources.

Prerequisites for building

Install

npm install node-zopfli-es

or if you want zopfli binary globally

npm install -g node-zopfli-es

Usage examples

Binary (from command line)

To gzip a file

zopfli file.txt

To compress a png file

zopflipng file.png out.png

Stream (async):

const zopfli = require('node-zopfli-es')
fs.createReadStream('file.js')
  .pipe(zopfli.createGzip(options))
  .pipe(fs.createWriteStream('file.js.gz'))

Instead of zopfli.createGzip, you can also use

new Zopfli('gzip', options)

Buffer (async):

const zopfli = require('node-zopfli-es')
const input = new Buffer('I want to be compressed')
zopfli.deflate(input, options, function (err, deflated) {})
zopfli.zlib(input, options, function (err, zlibed) {})
zopfli.gzip(input, options, function (err, gziped) {})

Buffer (sync):

const zopfli = require('node-zopfli-es')
const input = new Buffer('I want to be compressed')
const deflated = zopfli.deflateSync(input, options)
const zlibed = zopfli.zlibSync(input, options)
const gziped = zopfli.gzipSync(input, options)

API

compress(input, [format = 'deflate', options = {}, callback])

input is the input buffer (or string)

format can be one of deflate, zlib and gzip, deflate is the default if omitted

callback, if present, gets two arguments (err, buffer) where err is an error object, if any, and buffer is the compressed data.

If format is a function and callback is not, format is set to deflate and callback gets set If options is a function and callback is not, options are set to {} and callback gets set

If no callback is provided, it returns an A+ Promise.

aliases

deflate, zlib and gzip methods are aliases on compress without format argument.

deflate(input, [options = {}, callback])

zlib(input, [options = {}, callback])

gzip(input, [options = {}, callback])

Options

Here are the options with defaults values you can pass to zopfli:

{
  verbose: false,
  verbose_more: false,
  numiterations: 15,
  blocksplitting: true,
  blocksplittinglast: false,
  blocksplittingmax: 15,
}
numiterations

Maximum amount of times to rerun forward and backward pass to optimize LZ77 compression cost. Good values: 10, 15 for small files, 5 for files over several MB in size or it will be too slow.

blocksplitting

If true, splits the data in multiple deflate blocks with optimal choice for the block boundaries. Block splitting gives better compression.

blocksplittinglast

If true, chooses the optimal block split points only after doing the iterative LZ77 compression. If false, chooses the block split points first, then does iterative LZ77 on each individual block. Depending on the file, either first or last gives the best compression.

blocksplittingmax

Maximum amount of blocks to split into (0 for unlimited, but this can give extreme results that hurt compression on some files).

Build from sources

git clone https://github.com/jaeh/node-zopfli-es --recursive
cd node-zopfli-es
npm install

Tests

@magic/test is used, you can run it with:

npm test

The npm test command also runs nyc to create coverage reports.

Fast testing without coverage:

npm start

Formatting

@magic/test also includes prettier:

# equal to: prettier --write
npm run format

# equal to: prettier --list-different
npm run format:check

Typescript

Someone pushed the type definitions to DefinitelyTyped:

npm install @types/node-zopfli-es

Typescript definitions