imagemin

What is imagemin?

The imagemin npm package is a powerful tool for image compression and optimization. It allows developers to reduce the size of images without losing quality, which can significantly improve the performance of web applications by reducing load times.

What are imagemin's main functionalities?

Basic Image Compression

This code demonstrates how to use imagemin to compress JPEG and PNG images. The images are taken from the 'images' directory and the compressed versions are saved in the 'build/images' directory. The quality of JPEG images is set to 75, and the quality of PNG images is set between 60% and 80%.

const imagemin = require('imagemin');
const imageminMozjpeg = require('imagemin-mozjpeg');
const imageminPngquant = require('imagemin-pngquant');

(async () => {
    const files = await imagemin(['images/*.{jpg,png}'], {
        destination: 'build/images',
        plugins: [
            imageminMozjpeg({quality: 75}),
            imageminPngquant({quality: [0.6, 0.8]})
        ]
    });

    console.log(files);
})();

GIF Optimization

This code demonstrates how to optimize GIF images using imagemin. The GIF images are taken from the 'images' directory and the optimized versions are saved in the 'build/images' directory. The optimization level is set to 3, which is the highest level of optimization.

const imagemin = require('imagemin');
const imageminGifsicle = require('imagemin-gifsicle');

(async () => {
    const files = await imagemin(['images/*.gif'], {
        destination: 'build/images',
        plugins: [
            imageminGifsicle({optimizationLevel: 3})
        ]
    });

    console.log(files);
})();

SVG Optimization

This code demonstrates how to optimize SVG images using imagemin. The SVG images are taken from the 'images' directory and the optimized versions are saved in the 'build/images' directory. The SVGO plugin is configured to keep the viewBox attribute and not to remove IDs.

const imagemin = require('imagemin');
const imageminSvgo = require('imagemin-svgo');

(async () => {
    const files = await imagemin(['images/*.svg'], {
        destination: 'build/images',
        plugins: [
            imageminSvgo({
                plugins: [
                    {removeViewBox: false},
                    {cleanupIDs: false}
                ]
            })
        ]
    });

    console.log(files);
})();

Other packages similar to imagemin

sharp

Sharp is a high-performance image processing library that supports various image formats. It is known for its speed and efficiency, making it a popular choice for image resizing, cropping, and format conversion. Unlike imagemin, which focuses on compression and optimization, sharp provides a broader range of image manipulation functionalities.

jimp

Jimp is a pure JavaScript image processing library that does not require any external dependencies. It supports a wide range of image manipulation features, including resizing, cropping, and color adjustments. While imagemin is primarily used for image compression, Jimp offers a more comprehensive set of image editing tools.

image-webpack-loader

Image-webpack-loader is a loader for webpack that optimizes images during the build process. It uses imagemin under the hood but integrates seamlessly with webpack, making it a convenient choice for developers who are already using webpack for their build process. It provides similar functionalities to imagemin but is designed to work specifically within the webpack ecosystem.

README

imagemin

Minify images seamlessly

Install

$ npm install --save imagemin

Usage

const imagemin = require('imagemin');
const imageminMozjpeg = require('imagemin-mozjpeg');
const imageminPngquant = require('imagemin-pngquant');

imagemin(['images/*.{jpg,png}'], 'build/images', {
	use: [
		imageminMozjpeg({targa: true}),
		imageminPngquant({quality: '65-80'})
	]
}).then(files => {
	console.log(files);
	//=> [{data: <Buffer 89 50 4e …>, path: 'build/images/foo.jpg'}, …]
});

API

imagemin(input, output, [options])

Returns a promise for an array of objects in the format {data: Buffer, path: String}.

input

Type: array

Files to be optimized. See supported minimatch patterns.

output

Type: string

Set the destination folder to where your files will be written. If no destination is specified no files will be written.

options

use

Type: array

Array of plugins to use.

imagemin.buffer(buffer, [options])

Returns a promise for a buffer.

buffer

Type: buffer

The buffer to optimize.

options

use

Type: array

Array of plugins to use.

Related

• imagemin-cli - CLI for this module
• imagemin-app - GUI app for this module.
• gulp-imagemin - Gulp plugin.
• grunt-contrib-imagemin - Grunt plugin.

License

MIT © imagemin