Fetching contributors…
Cannot retrieve contributors at this time
45 lines (23 sloc) 1.85 KB

Visual Regression Testing


We want to ensure that there are no unexpected look and feel changes, when we deliver new versions of our application.


Use node-resemble-js to perform a visual diff of our pages, during our end to end tests.


In our isomorphic starter kit, we created a nightwatch custom assertion library that runs in the e2e testing phase.

When you run the assertion for the first time, it will generate and store new baseline screenshots for your tests.

While these baseline screenshots are created automatically, they will have to be manually committed to your git repo. This is considered best practice to ensure code changes and baseline screenshots are versioned side-by-side.

On subsequent executions, new screenshots will be made and compared with the baseline. If there is a difference greater than the specified threshold, the tests will fail and abort the delivery pipeline. If the change is desirable, you simply need to update the baseline screenshots with new versions to allow subsequent success of the pipeline.


the threshold value is customizable, a recommended & default value of 5% is usd in the starter kit to accommodate for slight differences in fonts, etc...

The visual diff will mark the problem areas with a purple overlay:

Visual regression example


Writing visual regression tests: Given how it is implemented, teams only need to define the threshold/delta upon story completion

Running visual regression tests: As part of the delivery pipeline



  • @design: Baseline Images
  • @delivery @qa @developers: tooling & automation