Skip to content
Sahi Pro Flowcharts is retired. These pages document the last release (v12) and are no longer updated. Go to the current documentation.Flowcharts is retired. Current docs
Get Free Trial
Sahi Pro Flowcharts is retired. These pages document the last release (v12) and are no longer updated. Go to the current documentation.

Screenshot APIs

Sahi's Screenshot APIs takes the screen/browser screen-shot while running the sahi scripts.

Modes BrowserWindowsJavaAndroidiOSSAP

Takes a screen shot and embeds the image in the playback log.
Since Sahi works without bringing the window into focus, we first need to call _focusWindow to bring the window into focus.

Parameters

NameTypeDescription
$fileSysPathstringoptionalfile path to copy screenshot in file system. Relative path resolves relative to files folder of the current project.
$noLogbooleanoptionaltrue to prevent embedding the image in the playback log.
Default is false.
$propsobjectoptionalproperties for image format(format) and image compression in precentage(resizePercentage)

1. format, string, optional, can be GIf, JPG or PNG
Default is "sahi.screenshot.image.format" property defined in config/sahi.properties, this can be overridden in userdata/config/userdata.properties

2. resizePercentage, integer, optional
Default is "sahi.screenshot.image.resize_percentage" property defined in config/sahi.properties, this can be override in userdata/config/userdata.properties
100 means no compression
Raw script
_focusWindow(); // bring window into focus
_takeScreenShot();
// captures screenshot in D:\dev\capture.jpg(compresses file size to 75% of the full size with jpg format)
// without embedding image in the playback log
_takeScreenShot("D:\\dev\\capture.jpg", true, {format:'jpg', resizePercentage:75});

Sahi Pro Classic API _takeScreenShot

Modes BrowserWindowsJavaAndroidiOSSAP

Takes a screen shot after every step and embeds the image in the playback log.

Parameters

NameTypeDescription
$enablebooleantrue for enabling screenshots, false to disable
$directorystringoptionalfile path directory to copy screenshot in file system
$noLogbooleanoptionaltrue to prevent embedding the image in the playback log.
Raw script
_focusWindow(); // bring window into focus
// Enable screenshots
_takeScreenShots(true);
// perform actions
// screenshot will be taken after each step
// disable screenshots
_takeScreenShots(false);
// screenshots will not be taken now.

Sahi Pro Classic API _takeScreenShots

Modes BrowserWindowsJavaAndroidiOSSAP

Takes a full page screenshot of a web page by scrolling to the end of the page and embeds the image in the playback log. If the element attribute is specified, a full page screenshot of the browser element is taken, instead of the web page. Since Sahi works without bringing the window into focus, we first need to call _focusWindow to bring the window into focus.

Parameters

NameTypeDescription
$elementHTML DOM elementoptionalIf specified, a full page screenshot of the element would be taken
$fileSysPathstringoptionalFile system path to save a copy of the screenshot, additionally to. Relative paths will be resolved relative to files folder of the current project.
Default is null.
$noLogbooleanoptionalPass true to prevent embedding the image in the playback log.
Default is false.
$propsobjectoptionalProperties to specify for image delay, scrollLimit, trim, format and image compression in percentage(resizePercentage).

1. delay, integer, optional, time delay between scroll and screenshot in milliseconds.
For long pages, the page is scrolled, individual screenshots are taken and then stitched.
Sometimes images on the page may load slowly on scroll and a wait may be needed between scroll and screenshot.
Default is 100 ms.

2. scrollLimit, integer, optional, height in pixels. Maximum scroll size in pixels for a page/element. Default is 200000.

3. trim, boolean, optional, Trim the image for blank space. Default is false.

4. format, string, optional, can be GIF, JPG or PNG
Default is "sahi.screenshot.image.format" property defined in config/sahi.properties. This can be overridden in userdata/config/userdata.properties

5. resizePercentage, integer, optional
Default is "sahi.screenshot.image.resize_percentage" property defined in config/sahi.properties. This can be overridden in userdata/config/userdata.properties. 100 means no compression.

6. mode, integer, optional
Default is 1.
Set to 2 only if element parameter is specified and element has scrollbar or element is inside a scrolled element.

For Desktop Applications, only format and resizePercentage properties($props) are supported, other properties($props) are not.
Raw script
_focusWindow(); // Brings window into focus
_takePageScreenShot(); // Captures the full browser page screenshot
_takePageScreenShot(_table("t4")); // Captures the table screenshot
// Captures table screenshot with jpg format, compresses file size to 75% of the full size, saves it to D:\dev\capture.jpg
// without embedding image in the playback log
_takePageScreenShot(_table("t4"), "D:/dev/capture.jpg", true, {format:'jpg', resizePercentage:75});
// Captures full div screenshot by scrolling to the end of the div.
// Use it in cases where a div has its own scrollbar.
_call(_div("myDIV").scrollIntoView()); // scroll the div into view first
_takePageScreenShot(_div("myDIV"), null, null, {mode:2}); // the div itself will be scrolled and screen shots taken

Sahi Pro Classic API _takePageScreenShot

Modes Browser

When enabled, actions namely Take Screenshot, Take Screenshots and Take Page Screenshot will be skipped. Capturing screenshot from Callback functions will also be skipped.

Parameters

NameTypeDescription
$enablebooleanTrue to skip screenshots, false to disable.
Raw script
// Skip capturing screenshots
_skipScreenShots(true);
_focusWindow();
_takeScreenShot(); // This will be skipped
// Enable capturing screenshots
_skipScreenShots(false);
// Now, screenshot APIs will not be skipped.

Sahi Pro Classic API _skipScreenShots

Modes Browser

When enabled, action Compare Images that compares screenshots will be skipped.

Parameters

NameTypeDescription
$enablebooleanTrue to skip comparing screenshots, false to disable.
Raw script
// Skip comparing screenshots
_skipScreenShotsComparison(true);
_focusWindow();
_takePageScreenShot(null, "D:/dev/images/login.png")
// Below line will be skipped
var $same = _compareImages("snapshot_login_page.png", "D:/dev/images/login.png");
// Enable comparing screenshots
_skipScreenShotsComparison(false);

Sahi Pro Classic API _skipScreenShotsComparison

Modes BrowserWindowsJavaAndroidiOSSAP

This action is used when asserting screenshot. It captures the full page screen shot of the screen or the specified element. The captured screenshot should be used for assertion by comparing with a reference image.
If the difference between the page screenshot and the reference image is lesser than or equal to the differenceThreshold, the images will be treated as same and the assertion is successful. Else the assertion is treated as a failure.
If the assertion is successful and displayOnSuccess is true, the page screenshot, reference image and the differential image will be embedded in the playback log.
If the assertion is a failure, Get Snap Shot will log failures to the playback log. The page screenshot, reference image and the differential image will be embedded in the playback log.

Parameters

NameTypeDescription
$elementHTML DOM elementoptionalIf specified, a full page screenshot of the element would be compared with the reference image. If not, a full page screenshot of the webpage would be compared with the reference image.
$differenceThresholdfloatoptionalIf the difference between the reference image and the page screenshot is lesser than or equal to the differenceThreshold number, they are considered same.
If not specified, a value of 20 is assumed.
$displayOnSuccessbooleanoptionalWhen true, the page screenshot, reference image and the differential image will be embedded in the playback log, if the assertion succeeds.
Default is false.
Note that these images will always be embedded in case of assertion failure.
$propsobjectoptionalProperties to specify for image delay, scrollLimit, trim, format and image compression in percentage(resizePercentage). 1. delay, integer, optional, time delay between scroll and screenshot in milliseconds.
For long pages, the page is scrolled, individual screenshots are taken and then stitched.
Sometimes images on the page may load slowly on scroll and a wait may be needed between scroll and screenshot.
Default is 100 ms.

2. scrollLimit, integer, optional, height in pixels. Maximum scroll size in pixels for a page/element. Default is 200000.

3. trim, boolean, optional, Trim the image for blank space. Default is false.

4. format, string, optional, can be GIF, JPG or PNG
Default is "sahi.screenshot.image.format" property defined in config/sahi.properties. This can be overridden in userdata/config/userdata.properties

5. resizePercentage, integer, optional
Default is "sahi.screenshot.image.resize_percentage" property defined in config/sahi.properties. This can be overridden in userdata/config/userdata.properties. 100 means no compression.

6. mode, integer, optional
Default is 1.
Set to 2 only if element attribute is specified and element has scrollbar.

Returns

stringFile path of the snapshot. Relative paths will be resolved relative to files folder of the current project.
Raw script
_navigateTo("http://sahi.co.in/demo/training");
_assertSnapShot("snapshot_login_page.png", _div(0), 20, true); // only _div(0) content would be compared with reference image.
// OR
_assertSnapShot("snapshot_login_page.png", null, 20, true); // passing null to compare with entire window screenshot
// OR
_assertSnapShot("snapshot_login_page.png",_div("myDIV"), 20, true, {mode:2}); // the div itself will be scrolled and screen shots taken

Sahi Pro Classic API _assertSnapShot

Modes BrowserWindowsJavaAndroidiOSSAP

Takes the path of the 2 images and checks if both images are same or not.

Parameters

NameTypeDescription
$f1stringFile path of the first image. Relative paths will be resolved relative to files folder of the current project.
$f2stringFile path of the second image. Relative paths will be resolved relative to files folder of the current project.
$differenceThresholdfloatoptionalIf the difference between first and second image is lesser than or equal to the differenceThreshold number, they are considered to be same images.
Default is 20.

Returns

booleantrue if both images are same, else false
Raw script
_navigateTo("http://sahi.co.in/demo/training");
_takePageScreenShot(null, "D:/dev/images/login.png")
var $same = _compareImages("snapshot_login_page.png", "D:/dev/images/login.png");
_assert($same);

Sahi Pro Classic API _compareImages

To configure GraphicsMagick, follow the following steps.

  • Download GraphicsMagick “GraphicsMagick-x.x.x-Qx-winxx-dll.exe” from GraphicsMagick windows

  • Install GraphicsMagick on your machine, say in C:\GraphicsMagick\

  • Edit sahi_pro\ext\imagetools\set_graphicsmagick.bat and modify the contents to look like this:

    Terminal window
    set GM=C:\GraphicsMagick\gm
  • Download GraphicsMagick “GraphicsMagick-x.x.xx-x.src.rpm” from GraphicsMagick linux

  • Install GraphicsMagick on your machine using apt/yum or your package manager. It would mostly install gm in /usr/bin/ (You can find the installed path by running which gm) for more details Refer here.

  • Edit sahi_pro/ext/imagetools/set_graphicsmagick.sh and modify the contents to look like this:

    Terminal window
    export GM=/usr/bin/gm
  • Download GraphicsMagick “GraphicsMagick-x.x.xx-x.tar.gz” from GraphicsMagick Mac

  • Install GraphicsMagick on your machine using brew install graphicsmagick or your package manager. It would mostly install gm in /usr/bin/ (You can find the installed path by running which gm) for more details Refer here.

  • Edit sahi_pro/ext/imagetools/set_graphicsmagick.sh and modify the contents to look like this:

    Terminal window
    export GM=/usr/bin/gm

Screenshot capturing can be skipped using Skip Screenshots action. With this, actions namely Take Screenshot, Take Screenshots and Take Page Screenshot will be skipped. Capturing screenshot from Callback functions will also be skipped.
Screenshot comparison can be skipped using Skip Screenshots Comparison action. With this, action Compare Images that compares screenshots will be skipped.
To skip screenshots in report on aborted, set property reports.skip_screenshots_on_aborted as true in userdata.properties file.

To skip screenshots in report on healed, set property reports.skip_screenshots_on_healed as true in userdata.properties file.

  • If you use phantomjs browser to execute screenshot related API’s scripts, use only "png" format to save the screenshots.
  • Refer here for troubleshooting incorrect screenshot in Mac.
  • Refer here for troubleshooting incorrect screenshot with dual screen.