Perfecto Command
mobile:text:find
Purpose
Locates the test specified by the content parameter and stores its coordinates on the device for future use by other operations. Note that these coordinates are not sent back as return value.
This command is used as the first step in a Visual Relationship sequence:
- Perform Find text to identify the location of the string on the screen.
- Perform a text visual analysis command using the visual relation parameters to identify the element relative to the text identified with the Find text execution.
Parameters
| Name | Type | Possible Values | Description |
|---|---|---|---|
| content* | String |
|
The text to search for. It is recommended to use the entire string searched for, to ensure that if the OCR misses a few characters, the needle will still be found. The text-match algorithm is less error-prone when the provided string is longer. |
| context | String | all | body | Defines the screen region where to look for the needle. |
* Mandatory parameter
In addition, the General Visual Analysis common and text parameters are supported.
Return Value
String indicating success ("true") or failure ("false")
Exceptions
None
Examples
Copy
Java sample
Map<String, Object> params = new HashMap<>();
params.put("content", "sound");
params.put("context", "body");
String res = (String)driver.executeScript("mobile:text:find",params);Copy
C# sample
Dictionary<String, Object> pars = new Dictionary<String, Object>();
pars.Add("content", "recorder");
pars.Add("context", "body");
String result = (String)driver.ExecuteScript("mobile:text:find",pars);