desktop » screenshot(name,file)

Description

This command instructs Nexial to capture the screenshot of a desktop component denoted by name. The name must resolve to a valid, visible desktop component in order for the screen capturing to execute successfully, otherwise the corresponding step will likely FAIL.

The captured screenshot is then saved to an external file, denoted by file. If file resolved to a directory, the corresponding step will result in a FAIL. If file exists, it will be overwritten. If file is not found, Nexial will attempt to create it, including any missing parent directory. Regardless of the file extension provided, the captured image will be in the PNG format.

Note:

• screen capturing can be disabled for the entire execution via nexial.screenshotEnabled System variable.

Parameters

• name - the name of the target component for screen capturing.
• file - the fully qualified path of the target image file.

Example

See Also

• nexial.screenshotEnabled
• screenshotByLocator(locator,file)