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:
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