Home

Integrates visual regression tests in CodeceptJS using the pixelmatch library. It works with all current CodeceptJS drivers: Playwright, Webdriver, Puppeteer, Appium, TestCafe.

Two screenshots are compared for differences, using a custom tolerance. When both images are equal enough, the test passes. When there are too many differences, the test fails.

What's special about this helper?

It's free!

This helper is open-source and only relies on other (free) open-source packages!

It's fast and private!

Comparison is done in memory on your machine by comparing pixel details. The images are not rendered into a hidden canvas, no data is sent or loaded to any web service.

It supports parallel execution!

This helper can be used with NodeJS Workers to enable parallel testing.

Multiple areas!

You can define a bounding rectangle, as well as multiple ignore-areas to only compare pixels that are relevant for the test.

Accurate calculation!

When using a bounding rectangle or ignore-areas, the library accurately counts relevant pixels to calculate the total difference between both images. Every pixel that's outside the bounds or inside an ignored area is not included in that calculation.

Great documentation!

Browse the GitHub wiki to learn everything about this library.

Thanks to

• This package is inspired by codeceptjs-resemblehelper.
• Thanks to everyone who contributes to pixelmatch, it's a great library to learn from
• The entire CodeceptJS community

---

Installation →