node-zopflipng

node-zopflipng

Node.js bindings for zopflipng.

Optimizes PNG images for size. This is very slow and should only be done for static resources.

Install

$ npm install --save node-zopflipng

Usage

const {optimizeZopfliPng} = require('node-zopflipng');
const {readFile, writeFile} = require('fs/promises');

readFile('./raw.png')
.then(buffer => optimizeZopfliPng(buffer))
.then(buffer => writeFile('./optimized.png', buffer));

API

optimizeZopfliPng(input, [options]): Promise

input

Type: Buffer

options

Type: Object

See Options for possible values.

optimizeZopfliPngSync(input, [options]): Buffer

Using this function is strongly discouraged. Running zopflipng can easily take more than 30s even on relatively small images (< 1 MB). optimizeZopfliPngSync will block the entire process during this time.

input

Type: Buffer

options

Type: Object

See Options for possible values.

Options

Name	Type	Default	Lossless	Description
lossyTransparent	boolean	false	✗	Remove colors behind alpha channel 0. No visual difference, removes hidden information.
lossy8bit	boolean	false	✗	Convert 16-bit per channel image to 8-bit per channel.
more	boolean	false	✓	Compress more. Uses more iterations depending on file size.
iterations	integer	15/5 (small/large)	✓	Number of iterations, more iterations makes it slower but provides slightly better compression. Default: 15 for small files, 5 for large files. Overrides more option.
keepChunks	string[]	[]	✓	Keep metadata chunks with these names that would normally be removed, e.g. tEXt, zTXt, iTXt, gAMA. Due to adding extra data, this increases the result size. By default ZopfliPNG only keeps (and losslessly modifies) the following chunks because they are essential: IHDR, PLTE, tRNS, IDAT and IEND.