unstale

npm / jimp

jimp

What changed in jimp 1, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-26.

16 breaking

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

@unstale/cli 0.2.8 on npm

jimp 116 changes

Breaking changes 16

  • Export methods are async, and getBase64 replaces getBase64Async.

    1.0.0upgrade guide

  • Export methods are async, and getBuffer replaces getBufferAsync.

    1.0.0upgrade guide

  • Encoding options such as quality are now passed to getBuffer when retrieving the encoded image, rather than set globally.

    1.0.0upgrade guide

  • Read image height from image.height instead of image.getHeight().

    1.0.0upgrade guide

  • intToRGBA moved from Jimp to a named package export.

    1.0.0upgrade guide

  • Jimp no longer uses a default export; import it as a named export.

    1.0.0upgrade guide

  • The constructor now takes an options object, including width, height, and an optional background color.

    1.0.0upgrade guide

  • Jimp.AUTO was removed because it was only needed for positional arguments.

    1.0.0upgrade guide

  • Load an image or canvas data from a bitmap with Jimp.fromBitmap instead of using the constructor.

    1.0.0upgrade guide

  • Load an image from a buffer with Jimp.fromBuffer instead of passing the buffer to the constructor.

    1.0.0upgrade guide

  • Use Jimp.read to load images asynchronously from disk in Node, from a URL in the browser, or from a Buffer or ArrayBuffer.

    1.0.0upgrade guide

  • Jimp.MIME_* constants moved to the named JimpMime export.

    1.0.0upgrade guide

  • Read the image MIME type from image.mime instead of image.getMIME().

    1.0.0upgrade guide

  • resize now takes an options object instead of positional width and height arguments.

    1.0.0upgrade guide

  • Read image width from image.width instead of image.getWidth().

    1.0.0upgrade guide

  • Export methods are async, and write replaces writeAsync.

    1.0.0upgrade guide