Application.Element.Find command

Finds an element or elements in the active application. Can be used to validate whether an element exists in the application. The returnValue of the response will indicate the UI Element hierarchy to the found element.

Parameters

Name

Type

Possible values

Description

Device ID*

Device

 

The device for this command. By default, this is the device under test (DUT).

Element identifier*

String

 

HTML attribute or XPath used to search for the element

By

String

XPath | Class | Text | Partial text | Name | Id | Accessibility id | UIAutomator Selector | UIAutomation Selector | Class Chain

The identification method.

Timeout

Number

 

The time, in seconds, to wait for the element to appear on the screen or the web page.

Result data table

DataTable

 

The datatable to which the results of the find will be added. The datatable can be used with other functions. It should have a single column of type STRING.

Report

String

Screenshot | Screenshot on error | None

The value to display in the report, where:

  • Screenshot displays a screenshot for each action

  • Screenshot on error displays screenshots only for actions in error

  • None does not display any screenshots

Consider reducing the resolution in very long scripts that result in large report files.

Report image resolution

String

High | Medium | Low

The image resolution.

Consider reducing the resolution in very long scripts that result in large report files.

Comment

String

 

Adds a comment to the script

On-fail Result*

Condition

Ignore | Break | Continue | Abort | Catch

The behavior when the command fails.

* Mandatory parameter