Table of contents

saveScreenshot

Description

Takes a screenshot in PNG format.

Field	Type	Description	Default
id	string	Optional. ID of the step.	Generated UUID
description	string	Optional. Description of the step.
action	string	Required. The action to perform.
path	string	Optional. Relative file path of the PNG file from `directory`. If not specified, the file name is the ID of the step.
directory	string	Optional. Directory of the PNG file. Attempts to create the directory if it doesn’t exist. If not specified, the directory is your media directory.
maxVariation	number	Optional. Allowed variation in percentage of pixels between the new screenshot and the exisitng screenshot at `path`. If the difference between the new screenshot and the existing screenshot is greater than `maxVariation`, the step fails. If a screenshot doesn’t exist at `path`, this value is ignored.
overwrite	string	Optional. If `true`, overwrites the existing screenshot at `path` if it exists.
If `byVariation`, overwrites the existing screenshot at `path` if the difference between the new screenshot and the existing screenshot is greater than `maxVariation`. Accepted values: `true`, `false`, `byVariation`	`false`

{
  "action": "saveScreenshot"
}

{
  "action": "saveScreenshot",
  "path": "results.png"
}

{
  "action": "saveScreenshot",
  "path": "results.png",
  "directory": "static/images"
}

{
  "action": "saveScreenshot",
  "path": "results.png",
  "directory": "static/images",
  "maxVariation": 10,
  "overwrite": "byVariation"
}