Skip to main content

Screener Visual Testing FAQ

Screener End-of-life

The Screener visual testing solution is going to be discontinued on May 31st, 2024. You can migrate to the new Sauce Labs Visual Testing solution by following the integration steps.

If you have any questions, please reach out to your Customer Success Manager or Sauce Labs Support.


Can I revert a recently accepted snapshot?

Yes. After accepting a snapshot, you can revert its acceptance before running another build:

  1. Go to the State Detail page.
  2. Click on the Accepted status dropdown.
  3. Select Revert.
    Revert accepted screenshot

How do I show lazy-loaded content in my screenshot?

You will need to trigger the lazy-loaded content so that it loads and displays in your web page. How to do this depends on how the lazy-loaded content is triggered to load.

For example, if content is loaded based on scrolling down to a particular section of your web page, then you will need to scroll to that section using JavaScript:

window.scroll(0, 1000)

Why is my screenshot not showing as a full page?

Sauce Visual captures a full-page screenshot by default in all browsers. The height of the full-page screenshot is based on the scrollable height of the main document body.

If the body is not scrollable, then the screenshot captured will appear to be cut off. For example, if the "overflow" style on the body is set to "hidden", then the body cannot be scrolled.

Are there workarounds?

Yes, but the workaround depends on how the website CSS was built, and understanding what is causing the body to not be scrollable.

If the overflow style on the body is "hidden", then the client could execute the following JS in an Execute Script command in the test to set body overflow to 'auto' before capturing a snapshot: = 'auto'

What happens if my page has broken HTML tags?

Sauce Visual assumes that there are no broken HTML tags on your pages and will not check for this.

Visual E2E

What Sauce Labs browsers are supported by Visual E2E?

Visual E2E is unified with Sauce VMs, and uses Sauce browsers exclusively. For a full list, see Visual E2E Supported Browsers and Operation Systems.

How do I test smaller mobile web viewport sizes for responsive design testing?

This can be done by setting viewportSize in your sauce:visual capabilities.

How do I run functional tests only after integrating Visual E2E?

If you want to run functional tests only, you do not need to modify any of your visual integration code. Just change your WebDriver endpoint from to

Does Screener capture iframes?

Yes — look for iframes and iframesOptions.

Component Testing

What Storybook versions are supported?

screener-storybook supports Storybook version 3.0 to 6.x (latest).

Why is Screener not picking up data from my CI build?

For screener-storybook and screener-runner tests run within a CI tool, Screener will automatically set build, branch, and commit options if you are using one of the CI tools below. It works by pulling data from environment variables in the CI job.

You'll see here that Jenkins looks for the following environment variables: JENKINS_URL or JENKINS_HOME, and BUILD NUMBER:
Screener Runner | Jenkins example
Screener Runner | GitLab CI example

If these environment variables are NOT accessible in the build, the reason is most likely that the CI is running the test job inside a separate container, and the variables need to be passed into the container.

How do I add Screener Steps to Storybook Component Story Format (CSF) stories?

Screener Storybook supports version 3.0 to 6.x (latest) and CSF-formatted stories. To see examples, refer to GitHub Gist | Three ways to add Screener Steps to a React Component in Storybook to CSF.

How do I add Screener Steps to my Storybook project that uses React Hooks?

React Hooks messes up using the Screener component because it executes its magic at runtime. So to use Screener Steps with React Hooks, you need to use Storybook Decorators to wrap the component story. Here is an example script: Storybook + Screener Steps with Hooks.

Does Sauce Visual interact with knobs within stories in Storybook and test as needed?

Screener-storybook does not automatically interact with knobs, as there could potentially be an infinite number of permutations. If there's a UI state that the user wants to get to using knobs, then this is possible with Screener Steps.

In the Storybook knobs add-on, there's a knobs UI where the user can copy a query string for the knobs configuration. They can copy this query string, and use it with the Screener Steps executeScript method to reproduce those knobs values.

Click on the copy button in the lower right, then paste into an editor, then copy only the query-string portion (after the ?) and paste that into a Screener step.

<Screener steps={new Steps()
.executeScript('window.location.href = "?path=/story/button&knob-Label=works"')

How do I resolve Error: Storybook object not found?

  1. Run test with --debug flag enabled. For example: npm run test-storybook -- --debug.

  2. After running with the debug flag, reach out to the Sauce Labs Support Team and provide them with your log output.

If the following logs are found, it means that Puppeteer could not be launched because of missing dependencies:

Error: Failed to launch chrome!
/node-packages/kanan_ui/node_modules/puppeteer/.local-chromium/linux-662092/chrome-linux/chrome: error while loading shared libraries: cannot open shared object file: No such file or directory

The Troubleshooting for Puppeteer documentation contains info on how to resolve this for various environments, such as TravisCI and CircleCI.

For information on setting up Puppeteer in GitLab, see How to set up Chrome Headless on GitLab CI with Puppeteer & Docker, which suggests installing all dependencies with the following command:

apt-get install gconf-service libasound2 libatk1.0–0 libc6 \
libcairo2 libcups2 libdbus-1–3 libexpat1 libfontconfig1 \
libgcc1 libgconf-2–4 libgdk-pixbuf2.0–0 libglib2.0–0 libgtk-3–0 \
libnspr4 libpango-1.0–0 libpangocairo-1.0–0 libstdc++6 libx11–6 \
libx11-xcb1 libxcb1 libxcomposite1 libxcursor1 libxdamage1 \
libxext6 libxfixes3 libxi6 libxrandr2 libxrender1 libxss1 \
libxtst6 ca-certificates fonts-liberation libappindicator1 \
libnss3 lsb-release xdg-utils wget -y