Ahmad Awais



Resize & Optimize Images With JavaScript in Node.js

Ahmad AwaisAhmad Awais

Lately, I have been working with a couple of image-intensive projects with Node.js, Next.js, React.js, and really only with JavaScript. I used to use a package called gm to optimize and resize images but that came at a cost of installing a couple of other native packages like GraphicsMagick and ImageMagick for node.

Naturally, that’s not a good thing for a project that’s being used by several developers on macOS, Windows, Linux, and on Raspberry Pi in the near future. So, in search of a better and JavaScript the only good solution I finally found a package called Jimp — which has been pretty great to work with. Props to Oliver Moran.

🔰 Resizing & Optimizing images in Node.js#

Let’s get started with Jimp and resize a set of images while also optimizing them in sort of an automated way. So, this is what you need:

❯ Install Jimp#

At this point, I assume that you have Node.js/npm installed and you have already kickstarted a project using npm init. Am I right?!

npm install jimp

❯ Read, Resize, Optimize, and Write#

Now that we have installed jimp, we need to use jimp to read an image path, resize it, optimize it, and finally write the new image to the same path.

const Jimp = require('jimp');

 * Resize + optimize images.
 * @param Array images An array of images paths.
 * @param Number width A number value of width e.g. 1920.
 * @param Number height Optional number value of height e.g. 1080.
 * @param Number quality Optional number value of quality of the image e.g. 90.
module.exports = async (images, width, height = Jimp.AUTO, quality) => {
	await Promise.all(
		images.map(async imgPath => {
			const image = await Jimp.read(imgPath);
			await image.resize(width, height);
			await image.quality(quality);
			await image.writeAsync(imgPath);


  • await Jimp.read(imgPath) Reading the image.
  • await image.resize(width, height) Resize the image with the given width but I don’t use height so the default value of Jimp.AUTO would resize the height as per the given width but keeping the same aspect ratio. This keeps things easy, you don’t have to do the math.
  • await image.quality(quality) Set a certain quality like 90%.
  • await image.writeAsync(imgPath) Write the image without callback in an async way. Super important to not use the .write method with async/await. I’ve been down that rabbit hole.

That’s pretty much about it. Go ahead and use this function.

📟 Node.js Module: resize-optimize-images#

That’s right. I have wrapped this in a nice little yet configurable node module called resize-optimize-images that you can install in your Node.js projects. This is how you go about it.

❯ Install#

npm install resize-optimize-images

❯ Usage#

const resizeOptimizeImages = require('resize-optimize-images');

(async () => {
	// Set the options.
	const options = {
		images: ['path/to/image.jpg', 'path/to/image.png'],
		width: 1920,
		quality: 90
	// Run the module.
	await resizeOptimizeImages(options);

Have fun hacking with JavaScript in Node.js. Use your code for good. Peace!

🌟 Don’t forget to star this repository resize-optimize-images

I help businesses understand developers 📟 Just launched Node.js CLI Automation Course 👨‍🏫 Edutainer at VSCode.pro 🎩 An award-winning GitHub Star open-source engineer & advocate 🦊 Google Developers Expert Web DevRel 🌳 Node.js foundation Community Committee Outreach Lead ✌️ Author of various open-source dev-tools and software libraries used by millions of developers worldwide ⓦ WordPress Core Developer 📣 TEDx Speaker 🙌 Leading developers and publishing technical content for over a decade 💜 Loves his wife (Maedah) ❯ Learn more →

Say 👋 on Twitter @MrAhmadAwais | Subscribe to the Developers Takeaway!


Developers Takeaway

Takeaway my professional opinion on open-source, developer relations, growing your business with family, and everything in between! Delivered to your inbox a couple of times every year. I'm even funny at times. I hate spam — pinky-promise!

👨‍💻👩‍💻 118,947 Developers Already Subscribed
Comments 0
There are currently no comments.