How to Upload Jest Image Snapshot Diffs to S3

Add snapshots from failed to S3 to enable running jest-image-snapshot on continuous integration server.

Every time I open a PR for this blog site that does anything more than add blog content, I run a visual regression test to ensure I didn't screw anything up.

I've been working with jest-image-snapshot to help in that process. This library takes screenshots when there are differences in snapshots.

Why S3?

This process is super helpful when running locally. I see the specs fail and I'm pointed to where the images are on my machine.

But when these specs run in an ephemeral environment like most continuous integration (CI) servers, I won't be able to access those files. They'll be gone by the time the test has failed.

To make these files viewable and still be able to run visual regression tests in CI, I upload the failed snapshots to S3. This is how I do it.


This post assumes:

  • A Jest test suite configured for your project.
  • You can programmatically access AWS. (See this post if not.)

Add Image Reporter

First, let's add the code that will upload the image snapshot on failure.


I like to put all my Jest config files (except the main config) in a .jest directory. You can put it wherever.


const chalk = require("chalk");
const fs = require("fs");
const AWS = require("aws-sdk");

// s3 bucket name
const bucket = process.env.AWS_BUCKET;
// directory in the bucket to place snapshots
const rootPath = "jest/diff_output";

const s3 = new AWS.S3({ apiVersion: "2006-03-01" });

class ImageReporter {
constructor(globalConfig, options) {
this._globalConfig = globalConfig;
this._options = options;

onTestResult(test, testResult, aggregateResults) {
if (
testResult.numFailingTests &&
testResult.failureMessage.match(/snapshot/) &&
) {
// location of local generated snapshots
const files = fs.readdirSync(
files.forEach((value) => {
// path to where they snapshots are stored in s3
const path = `${rootPath}/${value}`;
const params = {
Body: fs.readFileSync(
Bucket: bucket,
Key: path,
ContentType: "image/png",
s3.putObject(params, (err) => {
if (err) {
console.log(err, err.stack);
} else {
`Uploaded image diff file to <https://$>{bucket}.s3.amazonaws.com/${path}`

module.exports = ImageReporter;

Even though there's some length to this file, there’s not a whole lot happening. ImageReporter is a class that has an onTestResult method, which conditionally uploads failed snapshots to S3.

If you're interested in digging further, here is more info on Jest reporters.


Here's a link to this file in my repo. This was heavily influenced by this file that the library recommends. If you're having trouble with my version, you may want to try the library's version.

Update Jest Config

Assuming AWS is configured, you can then configure Jest to use the reporter. This is what it looked like for me, but this is a bit of a goofy configuration. If you have a more standard Jest config, it probably will look more like this:


module.exports = {
reporters: ["default", "<rootDir>/image-reporter.js"],
// other config items ...


My solution was heavily influence by this section of the jest-image-snapshot doc. That points to this file. It was really close to what I needed, but I had to change a few values to get it to work for me.

Let's Connect

Keep Reading

WTF is Continuous Integration?

Continuous integration was coined as an extreme programming practice, but is used more loosely today.

Jun 15, 2021

Adding S3 Credentials for Node.js AWS SDK

My go-to method for gaining access to AWS using the Node.js tooling.

Aug 20, 2021

2 Methods for Running Multiple Jest Suites in the Same Project

Multiple approaches on running a subset of Jest tests within a project.

Jun 03, 2022