Share this page
MobileWebElement Object
Description
A web element in a web view control in a mobile application.
This object is supported only when working with Mobile Center versions 1.5 and earlier.
Operations
The sections below list the built-in methods and properties that you can use as operations for the MobileWebElement object.
Note: You can also view a list and descriptions of the MobileWebElement description properties, for use in object repository descriptions, programmatic descriptions, checkpoint and output value steps, and as argument values for the GetTOProperty and GetROProperty methods.
Methods
 Check | Checks whether the actual value of an item matches the expected value. |
| CheckProperty | Checks whether the specified object property achieves the specified value within the specified timeout. |
| ChildObjects | Returns the collection of child objects contained within the object. |
| GetAllROProperties | Returns the collection of properties and current values from the object in the application. |
| GetROProperty | Returns the current value of the specified description property from the object in the application. |
| GetTOProperties | Returns the collection of properties and values used to identify the object. |
| GetTOProperty | Returns the value of the specified description property from the test object description. |
| Highlight | Highlights the object in the application. |
 LongPress | Presses and holds the object for a moment. |
| Output | Retrieves the current value of an item and stores it in a specified location. |
| Pan | Perform a Pan gesture on the object. |
| Pinch | Perform a Pinch gesture on the object. |
| RefreshObject | Instructs UFT One to re-identify the object in the application the next time a step refers to this object. |
| Set | Sets the specified text in the web element (relevant for edit boxes only). |
| SetFocus | Sets the focus on the web element. |
| SetTOProperty | Sets the value of the specified description property in the test object description. |
| Swipe | Swipes the object in the specified direction. |
| Tap | Taps the object. |
| ToString | Returns a string that represents the current test object. |
| WaitProperty | Waits until the specified object property achieves the specified value or exceeds the specified timeout before continuing to the next step. |
Properties
 Exist | Checks whether the object currently exists in the open application. |
LongPress Method
Description
Presses and holds the object for a moment.
Syntax
object.LongPress [x], [y], [Duration], [NumOfTouchPoints], [Gesture]
Arguments
| Parameter | Description |
|---|---|
| x |
Optional. An integer value. The x-coordinate of the long press. Note that the specified coordinates are relative to the upper left corner of the object. The default value is the center of the object. Default value = -9999 |
| y |
Optional. An integer value. The y-coordinate of the long press. Note that the specified coordinates are relative to the upper left corner of the object. The default value is the center of the object. Tip: You can enter micNoCoordinate (-9999) for the x and y argument values if you want to enter a value for the other optional arguments without specifying x- and y- coordinates for the long press. micNoCoordinate indicates the center of the object. Default value = -9999 |
| Duration |
Optional. A double floating value. The number of seconds to continue pressing. (Supported only on iOS) Default value = 0 |
| NumOfTouchPoints |
Optional. An integer value. The number of points to press, similar to the number of fingers you would use for the gesture on a real device. (Supported only on iOS) Supported value = 1 |
| Gesture |
Optional. A String value. The gesture class designed by the mobile application developer to handle this gesture on this object. (relevant for iOS only) Note: Default value = "" |
Return Type
None
Pan Method
Description
Perform a Pan gesture on the object.
Syntax
object.Pan StartX, StartY, EndX, EndY, [XVelocity], [YVelocity], [Gesture]
Arguments
| Parameter | Description |
|---|---|
| StartX |
Required. An integer value. The x-coordinate at which to start the pan gesture. Note that the specified coordinates are relative to the upper left corner of the object. |
| StartY |
Required. An integer value. The y-coordinate at which to start the pan gesture. Note that the specified coordinates are relative to the upper left corner of the object. |
| EndX |
Required. An integer value. The x-coordinate at which to end the pan gesture. Note that the specified coordinates are relative to the upper left corner of the object. |
| EndY |
Required. An integer value. The y-coordinate at which to end the pan gesture. Note that the specified coordinates are relative to the upper left corner of the object. |
| XVelocity |
Optional. A double floating value. The horizontal velocity of the pan gesture. Default value = -9999 |
| YVelocity |
Optional. A double floating value. The vertical velocity of the pan gesture. Default value = -9999 |
| Gesture |
Optional. A String value. The gesture class designed by the mobile application developer to handle this gesture on this object. (relevant for iOS only) Note: Default value = "" |
Return Type
None
Example
Perform a Pan Gesture (VBScript)
'The following example performs a Pan gesture on a MobileObject object
'in a Mobile application.
Device("Device").App("TouchesNI").MobileObject("yellow_view").Pan 46,20,58,137,-29.768660,44.604350
Pinch Method
Description
Perform a Pinch gesture on the object.
Syntax
object.Pinch Scale, [Velocity], [x], [y], [Gesture]
Arguments
| Parameter | Description |
|---|---|
| Scale |
Required. A double floating value. The scale for the pinch gesture. This number is the ratio between the start distance and the end distance between the two touch point used for the pinch. For example, if you were to touch a screen with your fingers 6 cm apart, and pinch until your fingers were 3 cm, apart, the scale would be 0.5. |
| Velocity |
Optional. A double floating value. The speed at which to perform the pinch gesture. This number specifies the scale factor per second. Meaning - ratio between the touch point distance at one second, and the touch point distance one second later. For example, if performing a pinch from 6 cm to 3 cm (0.5 scale) takes 2 seconds, then the velocity is 0.25. Default value = 0 |
| x |
Optional. An integer value. The x-coordinate for the pinch gesture. Note that the specified coordinates are relative to the upper left corner of the object. The default value is the center of the object. Default value = -9999 |
| y |
Optional. An integer value. The y-coordinate for the pinch gesture. Note that the specified coordinates are relative to the upper left corner of the object. The default value is the center of the object. Default value = -9999 |
| Gesture |
Optional. A String value. The gesture class designed by the mobile application developer to handle this gesture on this object. (relevant for iOS only) Note: Default value = "" |
Return Type
None
Example
Perform a Pinch Gesture (VBScript)
'The following example performs a Pinch gesture on a MobileObject object
'in a Mobile application.
Device("Device").App("TouchesNI").MobileObject("pink_View").Pinch 1.885921,0.700999,78,89
Set Method
Description
Sets the specified text in the web element (relevant for edit boxes only).
Syntax
object.Set Text
Arguments
| Parameter | Description |
|---|---|
| Text |
Required. A String value. The text to enter. |
Return Type
None
SetFocus Method
Description
Sets the focus on the web element.
Syntax
object.SetFocus
Return Type
None
Swipe Method
Description
Swipes the object in the specified direction.
Syntax
object.Swipe Direction, [x], [y], [Gesture]
Arguments
| Parameter | Description |
|---|---|
| Direction |
Required. A String value. The direction in which to swipe the object. Possible values: |
| x |
Optional. An integer value. The x-coordinate at which to start the swipe. Note that the specified coordinates are relative to the upper left corner of the object. The default value is the center of the object. Default value = -9999 |
| y |
Optional. An integer value. The y-coordinate at which to start the swipe. Note that the specified coordinates are relative to the upper left corner of the object. The default value is the center of the object. Default value = -9999 |
| Gesture |
Optional. A String value. The gesture class designed by the mobile application developer to handle this gesture on this object. (relevant for iOS only) Note: Default value = "" |
Return Type
None
IMPORTANT
During recording sessions on Android devices, this method is not recorded. You can add it to the test manually.
Example
Swipe an Object (VBScript)
'The following example performs a Swipe gesture on a MobileObject object
'in a Mobile application.
Device("Device").App("UICatalog").MobileObject("customviewpager").Swipe "up",545,1521
Tap Method
Description
Taps the object.
Syntax
object.Tap [x], [y], [NumberOfTaps], [NumOfTouchPoints], [Gesture]
Arguments
| Parameter | Description |
|---|---|
| x |
Optional. An integer value. The x-coordinate of the tap. Note that the specified coordinates are relative to the upper left corner of the object. The default value is the center of the object. Default value = -9999 |
| y |
Optional. An integer value. The y-coordinate of the tap. Note that the specified coordinates are relative to the upper left corner of the object. The default value is the center of the object. Default value = -9999 |
| NumberOfTaps |
Optional. An integer value. The number of times to tap the object. (Supported only on iOS) Default value = 1 |
| NumOfTouchPoints |
Optional. An integer value. The number of points to press, similar to the number of fingers you would use for the gesture on a real device. (Supported only on iOS) Default value = 1 |
| Gesture |
Optional. A String value. The gesture class designed by the mobile application developer to handle this gesture on this object. (relevant for iOS only) Note: Default value = "" |
Return Type
None
Example
Tap a Hybrid Object in a Mobile Application (VBScript)
'The following example taps a Hybrid object inside of a Mobile application.
Device("Device").App("com.example.hybrid").MobileWebView("MobileWebView").MobileWebElement("A").Tap
See also:
