jest-image-snapshot
jest-image-snapshot is a free, open-source Jest matcher for image comparison in visual regression testing.
What jest-image-snapshot is
jest-image-snapshot is a free, open-source Jest matcher for image comparison in visual regression testing. It stores a baseline image on the first run and compares later test images against that reference. Comparisons can use Pixelmatch pixel checking or structural similarity, with SSIM described as experimental. Users can set per-pixel sensitivity and an overall failure threshold by pixel count or percentage. Configurable Gaussian blur helps address noise from images scaled at different resolutions. The matcher can create horizontal or vertical diff layouts and optionally print a base64 diff or an iTerm inline image in the console. Installation uses npm, and the listed Jest peer dependency range is versions 20 through 29; versions below 20 are unsupported. Browser screenshots can serve as test inputs, while an example reporter uploads failed diffs to AWS S3 for ephemeral CI environments. Baselines can be refreshed with Jest’s --updateSnapshot or -u option. The package is self-hosted, has no cross-browser capture, and its TypeScript definitions are community maintained rather than officially supported.
Good
- Free open-source package
- Pixelmatch and SSIM comparisons
- Adjustable pixel and percentage thresholds
- Configurable Gaussian blur
- CI diff-upload example
Watch out
- Jest versions below 20 unsupported
- SSIM is experimental
- No cross-browser capture
- TypeScript definitions are unofficial
Who it suits
It suits developers using Jest who need repeatable image baselines and configurable visual-diff checks. It is especially relevant to browser screenshot tests and CI workflows.
Verdict
jest-image-snapshot adds baseline image comparisons and diff reporting to Jest tests. Its self-hosted npm workflow is useful when teams can manage screenshot capture and supported Jest versions themselves.
Plans and prices
From jest-image-snapshot's own pricing page, checked 4 Oct 2026.
| Plan | Price | What it gives you |
|---|---|---|
| Open source package | Free | Jest >=20 and <=29 peer dependency · Install with npm |
The facts
Each one read from jest-image-snapshot's own pages, with the date it was checked.
Where it runs
- Browser testing
- The README shows using a browser screenshot as the image input in a visual test.checked 4 Oct 2026
What it does
- CI image storage
- The README provides an example reporter that uploads failed diff images to an AWS S3 bucket for ephemeral environments.checked 4 Oct 2026
- Comparison methods
- It supports pixel-by-pixel Pixelmatch comparison and structural similarity (SSIM) comparison, which the README describes as experimental.checked 4 Oct 2026
- Diff output
- The matcher can create horizontal or vertical diff layouts and optionally print a base64 diff or an iTerm inline image to the console.checked 4 Oct 2026
- Installation
- The README gives `npm i --save-dev jest-image-snapshot` as the installation command.checked 4 Oct 2026
- Jest compatibility
- The README lists Jest versions 20 through 29 as a peer dependency and says versions below 20 are unsupported.checked 4 Oct 2026
- License
- The project states that contributions are governed by the Apache License 2.0.checked 4 Oct 2026
- Noise handling
- A configurable Gaussian blur can help address noise from scaling images at different resolutions.checked 4 Oct 2026
- Purpose
- A Jest matcher for comparing images, commonly used for visual regression testing.checked 4 Oct 2026
- Snapshots
- It saves a baseline image on the first run and compares later test images against it.checked 4 Oct 2026
- Thresholds
- Users can set per-pixel sensitivity and an overall failure threshold measured in pixels or percent.checked 4 Oct 2026
- TypeScript support
- The README says the community-maintained DefinitelyTyped definitions may be outdated or inaccurate and are not officially supported by the maintainers.checked 4 Oct 2026
- Update baselines
- Jest’s `--updateSnapshot` or `-u` option updates stored image snapshots.checked 4 Oct 2026
The company
- Maker
- American Express says it was founded in 1850 and is headquartered in New York.checked 4 Oct 2026
Alternatives to jest-image-snapshot
- 1

Happo
Free planAndroidiOSWebAPI8.1From $149 a month - 2
Screenster
Free planWebAPISelf-hostedWindows7.6From $25 a month - 3

Percy
Free planAndroidiOSWeb7.5From $199 a month - 4

Loki
Free planAndroidiOSWebLinux7.3Free plan - 5
Roborazzi
Free planAndroidiOSLinuxmacOS7.2Free plan - 6

SmartUI
Free planAndroidiOSWebAPI7.2From $199 a month
