Line screenshots

Line screenshots are taken either through scheduled tests in automated mode or by Suitest JavaScript API commands takeScreenshot and saveScreenshot. Screenshots made in tests executed by Suitest web application (not JavaScript API) can then be found in the results of your test runs.

Two ways of taking screenshots

Suitest offers two ways of taking screenshots from testing devices.

Screenshots from the device over network

Supported platforms

  • Android
  • Apple iPhone / iPad (iOS) devices and simulators
  • Apple TV (tvOS) devices and simulators
  • Browsers
  • HbbTV (on LG webOS TVs 2016+)
  • LG webOS (2016+)
  • PlayStation 4/5
  • Roku
  • Xbox (One, Series X/S)
Currently not supported on

  • HbbTV / Freeview Play
  • Samsung Tizen
  • Vizio SmartCast
  • Other Smart TVs and STBs

The first way is directly from the device, and it provides the highest possible image quality. Unfortunately, not all manufacturers allow taking screenshots from their devices.

You may experience issues when using Google Chrome and Microsoft Edge browsers running in headless mode on macOS.

Screenshots from Suitest Camera android app

Supported on all platforms

Not all the platforms support screenshots over network, Suitest provides you with an alternative way - using our Suitest Camera application for Android mobile devices. You just need to:

  1. Install the Suitest Camera app on your Android mobile
  2. Pair the application with your Suitest account
  3. If needed, pair the application with your testing device
  4. Aim the camera of your Android mobile device at the screen of your testing device
  5. Make sure that the connection is established

Note: If the testing device does allow screenshots over the network, screenshots will be taken that way instead.

Tests in web UI

Within the test editor you can mark the test lines on which you would like to take a screenshot. Screenshots are taken after the line has been executed.

Test editor screenshots enabling

Toolbar screenshot button - allows to select multiple lines

Test packs

In the test pack schedule tab you can configure when screenshots are taken using the following options:

  • Take screenshots according to test definition - takes screenshots based on the lines that you have marked in the test editor
  • Take a screenshot after each test line - takes screenshots after each line that has been executed
  • Do not take screenshots according to test definition - ignore screenshot marks in test editor
  • Take a screenshot after each failed line - take a screenshot after every failed test line, no matter if it was marked in test editor or not

Screenshots schedule tab configuration


On the results page you will find all the screenshots that have been taken. The screenshot icon will open the screenshots viewer.

Please note that execution times may be affected by screenshots being taken.

Results - test definition

The device screenshot viewer allows you to navigate between screenshots on each test line and device.

Device screenshot viewer

Tip: Quickly navigate in the view by using keyboard arrows, left / right to switch test lines and up / down to switch devices.

Tests in JS API

When running a test using Suitest JavaScript API, there are two commands related to screenshots: - takeScreenshot - takes a screenshot from the device in base64 format, - saveScreenshot - takes a screenshot from the device in PNG format.

Storing of screenshots is then fully up to the user - no screenshots is stored on Suitest servers.