sharp 0.33.2

Sharp is a high-performance Node.js module used for image processing. It is the fastest tool to resize images, especially JPEG, PNG, WebP, GIF, AVIF, and TIFF formats. The typical use case is to convert large images to smaller, web-friendly ones with varying dimensions. Apart from resizing, it offers operations like rotation, extraction, compositing, and gamma correction. Sharp is faster than using quickest ImageMagick and GraphicsMagick settings due to its use of libvips.

Sharp is easy to use with Node.js. First, install it using npm with the command npm install sharp. Once installed, require it in your JavaScript file like const sharp = require('sharp'). You can then use it to resize, rotate or change image setting.

Here are some usage examples: Callback method:

const sharp = require('sharp');
sharp(inputBuffer)
  .resize(320, 240)
  .toFile('output.webp', (err, info) => { ... });

Promise method:

const sharp = require('sharp');
sharp('input.jpg')
  .rotate()
  .resize(200)
  .jpeg({ mozjpeg: true })
  .toBuffer()
  .then( data => { ... })
  .catch( err => { ... });

Async/await method:

const sharp = require('sharp');
const semiTransparentRedPng = await sharp({
  create: {
    width: 48,
    height: 48,
    channels: 4,
    background: { r: 255, g: 0, b: 0, alpha: 0.5 }
  }
})
  .png()
  .toBuffer();

Stream method:

const sharp = require('sharp');
const roundedCorners = Buffer.from(
  '<svg><rect x="0" y="0" width="200" height="200" rx="50" ry="50"/></svg>'
);

const roundedCornerResizer =
  sharp()
    .resize(200, 200)
    .composite([{
      input: roundedCorners,
      blend: 'dest-in'
    }])
    .png();

readableStream
  .pipe(roundedCornerResizer)
  .pipe(writableStream);

You can find the complete documentation for sharp at sharp.pixelplumbing.com. The documentation provides complete installation instructions, API documentation, benchmark tests, and a changelog.