| title | page_title | description | position | publish | slug |
|---|---|---|---|---|---|
iOS |
iOS |
Telerik Mobile Testing - API Reference - iOS |
0 |
true |
ms-ios-api |
Methods DragCellToIndexPath DragToDisplacement DragToPoint ElementExists ElementVisible GetPropertyValue PressDismiss PressReturn PinchIn PinchOutScrollToItem ScrollToRow SelectRowInComponent SelectRow SelectItem SetDate SetText SetValue Screenshot Swipe TapTapAtLocation TapAtPoint TapCenterLeft TapCenterRight TapAndHold TypeText TapSubviewAtIndex Toggle TwoFingerRotate Wait WaitForElementExists WaitForElementVisible WaitForPropertyValue
Methods for automating native iOS applications.
##Methods
Drags the cell from the specified row and section to a different row and section.
Supports views and subclasses of: UITableView.
query (IOSQuery) - Identifies an element uniquely.
fromRow (int) - The row to drag from.
fromSection (int) - The section that contains the fromRow.
toRow (int) - The row to drag to.
toSection (int) - The section that contains the toRow.
// This will drag table cell from row 1 to row 4 in the TableView
this.ActiveDevice.IOS.DragCellToIndexPath(Elements.MyScreen.UITableView, 1,0,4,0); Me.ActiveDevice.IOS.DragCellToIndexPath(Elements.MyScreen.UITableView, 1,0,4,0)Performs a drag gesture from a location to a displacement from that location within the view specified by the query.
Supports views and subclasses of: UIView.
query (IOSQuery) - Identifies an element uniquely.
fromPoint (TapPoint) - The x, y position in the view to start the drag from.
displacement (TapPoint) - The x, y distance from the fromPoint to end the drag.
steps (int) - The amount of touches to generate to complete the drag. 3 minimum and not more than 1000.
// This will drag an item in UIView from 100x,100y point to 100x,300y point relative to that UIView using 200 touches
this.ActiveDevice.IOS.DragToDisplacement(Elements.MyScreen9.UIView, new TapPoint(100,100),new TapPoint(100,300),200);Me.ActiveDevice.IOS.DragToDisplacement(Elements.MyScreen9.UIView, New TapPoint(100, 100), New TapPoint(100, 300), 200)Performs a drag gesture from a location to a location within the view specified by the query.
Supports views and subclasses of: UIView.
query (IOSQuery) - Identifies an element uniquely.
fromPoint (TapPoint) - The x, y position in the view to start the drag from.
toPoint (TapPoint) - The x, y position in the view to end the drag.
steps (int) - The amount of touches to generate to complete the drag. 3 minimum and not more than 1000.
// This will drag an item in UIView from 100x,100y point to 100x,300y point in the same UIView using 200 touches
this.ActiveDevice.IOS.DragToPoint(Elements.MyScreen9.UIView, new TapPoint(100,100),new TapPoint(100,300),200);Me.ActiveDevice.IOS.DragToPoint(Elements.MyScreen9.UIView, New TapPoint(100, 100), New TapPoint(100, 300), 200)Checks if the view specified by the query exists, and returns the result as boolean.
Supports views and subclasses of: UIView.
query (IOSQuery) - Identifies an element uniquely.
Exists boolean
// This will verify that the UISwitch exists and return the result as booelan
bool exists = this.ActiveDevice.IOS.ElementExists(Elements.MyScreen9.UISwitch);Me.ActiveDevice.IOS.ElementExists(Elements.MyScreen9.UISwitch)Checks if the view specified by the query is visible, and returns the result as boolean.
Supports views and subclasses of: UIView.
query (IOSQuery) - Identifies an element uniquely.
isVisible boolean
// This will verify that the UISwitch is visible on the screen and return the result as booelan
bool visible = this.ActiveDevice.IOS.ElementVisible(Elements.MyScreen9.UISwitch);Dim visible As Boolean = Me.ActiveDevice.IOS.ElementVisible(Elements.MyScreen9.UISwitch)Retrieves the value of a property from a specified view.
Supports views and subclasses of: UIView.
query (IOSQuery) - Identifies an element uniquely.
propertyName (string) - The string name of the property.
The String value of the property.
// This will get the value of "text" property of a label and save it in the LabelText string
string LabelText = this.ActiveDevice.IOS.GetPropertyValue(Elements.MyScreen1.UILabel, "text");Dim LabelText As String = Me.ActiveDevice.IOS.GetPropertyValue(Elements.MyScreen1.UILabel, "text")Presses dismiss on the keyboard.
// This will press the dismiss key on the keyboard
this.ActiveDevice.IOS.PressDismiss();Me.ActiveDevice.IOS.PressDismiss()Presses return on the keyboard.
// This will press the return key on the keyboard
this.ActiveDevice.IOS.PressReturn();Me.ActiveDevice.IOS.PressReturn()Performs a pinch in gesture at the specified location within the view specified by the query.
Supports views and subclasses of: UIView.
query (IOSQuery) - Identifies an element uniquely.
point (TapPoint) - The x, y center point to pinch into the view. If null, defaults to center point in view.
distance (int) - The distance away from the center point to start the pinch. Cannot be less than 1.
steps (int) - The amount of touches to generate to complete the pinch in. Cannot be less than 3 and more than 1000.
// This will Pinch In over the center of the UIView and with each finger at 20 pixels from the center of the UIView. The Pinch in action will performed in 100 "touches".
this.ActiveDevice.IOS.PinchIn(Elements.MyScreen9.UIView,null,20,100);Me.ActiveDevice.IOS.PinchIn(Elements.MyScreen9.UIView,null,20,100)Performs a pinch out gesture at the specified location within the view specified by the query.
Supports views and subclasses of: UIView.
query (IOSQuery) - Identifies an element uniquely.
point (TapPoint) - The x, y position to pinch out from in the view. If null, defaults to center point in view.
distance (int) - The distance away from the center point to end the pinch. Cannot be less than 1.
steps (int) - The amount of touches to generate to complete the pinch out. Cannot be less than 3 and more than 1000.
// This will Pinch Out over the center of the UIView and with each finger at 20 pixels from the center of the UIView. The Pinch out action will performed in 100 "touches".
this.ActiveDevice.IOS.PinchOut(Elements.MyScreen9.UIView,null,20,100);Me.ActiveDevice.IOS.PinchOut(Elements.MyScreen9.UIView,null,20,100)ScrollToItem(IOSQuery[] query, int item, int section, IOSCollectionViewScrollPosition cvScrollPosition)
Scrolls to an item in a section on a view specified by the query.
Supports views and subclasses of: UICollectionView.
query (IOSQuery) - Identifies an element uniquely.
item (int) - Тhe index of the item to scroll to.
section (int) - Тhe section that contains the item to scroll to.
cvScrollPosition (IOSCollectionViewScrollPosition) - (enum) the position in the UI the item should scroll to.
// This will select an item with index 4 that is part of UICollection
this.ActiveDevice.IOS.SelectItem(Elements.MyScreen2.UICollectionView, 4, 0);Me.ActiveDevice.IOS.SelectItem(Elements.MyScreen2.UICollectionView, 4, 0)Scrolls to a row in a section on a view specified by the query.
Supports views and subclasses of: UITableView.
query (IOSQuery) - Identifies an element uniquely.
row (int) - Тhe row to scroll to.
section (int) - Тhe section that contains the row to scroll to.
tvScrollPosition (IOSTableViewScrollPosition) - (enum) The position in the UI the row should scroll to.
// This will scroll to row 5, section 0 of UITableView and will make sure that the row will appear as close as possible to the top of the screen
this.ActiveDevice.IOS.ScrollToRow(Elements.MyScreen.UITableView, 5, 0, IOSTableViewScrollPosition.Top);Me.ActiveDevice.IOS.ScrollToRow(Elements.MyScreen.UITableView, 5, 0, IOSTableViewScrollPosition.Top)Selects a row in a component of a view specified by the query.
Supports views and subclasses of: UIPickerView.
query (IOSQuery) - Identifies an element uniquely.
row (int) - The row to select.
component (int) - The index of the component that contains the row to select.
// Select row 5 from component 0 in the UIPicker
this.ActiveDevice.IOS.SelectRowInComponent(Elements.MyScreen5.UIPickerView, 5, 0);Me.ActiveDevice.IOS.SelectRowInComponent(Elements.MyScreen5.UIPickerView, 5, 0)Selects a row in a section on a view specified by the query.
Supports views and subclasses of: UITableView.
query (IOSQuery) - Identifies an element uniquely.
row (int) - The row to select.
section (int) - The table view section that contains the row to select.
//This will select row 5, section 0 from the UITableView element
this.ActiveDevice.IOS.SelectRow(Elements.MyScreen.UITableView, 5,0);Me.ActiveDevice.IOS.SelectRow(Elements.MyScreen.UITableView, 5,0)Selects an item in a section on a view specified by the query.
Supports views and subclasses of: UICollectionView. The item must currently be visible on the screen.
query (IOSQuery) - Identifies an element uniquely.
item (int) - The index of the item to select.
section (int) - The section that contains the item to select.
//This will select row 5, section 0 from the UITableView element
this.ActiveDevice.IOS.SelectRow(Elements.MyScreen.UITableView, 5,0);Me.ActiveDevice.IOS.SelectRow(Elements.MyScreen.UITableView, 5,0)Sets the date on a view specified by the query.
Supports views and subclasses of: UIDatePicker.
query (IOSQuery) - Identifies an element uniquely.
date (DateTime) - .NET DateTime object.
// This will set the value of a date picker to 2015-12-12 12:00 AM
this.ActiveDevice.IOS.SetDate(Elements.MyScreen3.UIDatePicker, new DateTime(2015, 12, 12));Me.ActiveDevice.IOS.SetDate(Elements.MyScreen3.UIDatePicker, new DateTime(2015, 12, 12))Sets the text on a view specified by the query.
Supports views and subclasses of: UITextField, UITextView, UISearchBar.
query (IOSQuery) - Identifies an element uniquely.
text (string) - The text value to set on the view.
// This will set "Set Text" string in the text field
this.ActiveDevice.IOS.SetText(Elements.MyScreen4.UITextField, "Set Text");Me.ActiveDevice.IOS.SetText(Elements.MyScreen4.UITextField, "Set Text")Sets the value of a view specified by the query.
Supports views and subclasses of UIStepper, and UISlider.
query (IOSQuery) - Identifies an element uniquely.
value (double) - The value the view should be set to.
newTimeout (int) - (optional) An amount of time in milliseconds to wait for the operation to complete.
// This will set Value of 0.5 of the UIStepper and fail the operation if it takes more than 100ms
this.ActiveDevice.IOS.SetValue(Elements.MyScreen8.UIStepper, 0.5, 100);Me.ActiveDevice.IOS.SetValue(Elements.MyScreen8.UIStepper, 0.5, 100)Takes a screenshot of the tested UI.
Supports views and subclasses of UIStepper, and UISlider.
The taken screen shot as array of bytes.
// This will make a screenshot of the app under test and return it as an array of bytes
byte[] screenshotInBytes = this.ActiveDevice.IOS.Screenshot();Dim screenshotInBytes As Byte() = Me.ActiveDevice.IOS.Screenshot()Performs a swipe gesture across the view specified by the query.
Supports views and subclasses of: UIView.
query (IOSQuery) - Identifies an element uniquely.
direction (SwipeDirection) - (enum) The direction to swipe.
// This will perform a swipe gesture over the UIView to the right
this.ActiveDevice.IOS.Swipe(Elements.MyScreen9.UIView, SwipeDirection.Right);Me.ActiveDevice.IOS.Swipe(Elements.MyScreen9.UIView, SwipeDirection.Right)Performs a tap gesture at the center of the view specified by the query.
Supports views and subclasses of: UIView.
query (IOSQuery) - Identifies an element uniquely.
tapCount (int) - (optional) How many times to tap. If null, defaults to 1.
tapDownDelay (int) - (optional) The amount of time tap down should last. Defaults to 10 milliseconds and cannot be less.
tapUpDelay (int) - (optional) The amount of time tap up should last, if multiple taps are used. Defaults to 10 milliseconds and cannot be less.
// This will tap twice UIRoundedRectButton and will use the default value for tapDownDealy and TapUpDelay
this.ActiveDevice.IOS.Tap(Elements.MyScreen1.UIRoundedRectButton, 2);Me.ActiveDevice.IOS.Tap(Elements.MyScreen1.UIRoundedRectButton, 2)Performs a tap gesture at the specified location within the view specified by the query.
Supports views and subclasses of: UIView.
query (IOSQuery) - Identifies an element uniquely.
x (int) - The x position to tap in the view.
y (int) - The y position to tap in the view.
tapCount (int) - (optional) - how many times to tap. If null, defaults to 1.
// This will tap twice UIRoundedRectButton at location x=5 and y =10
this.ActiveDevice.IOS.TapAtLocation(Elements.MyScreen1.UIRoundedRectButton, 5, 10, 2);Me.ActiveDevice.IOS.TapAtLocation(Elements.MyScreen1.UIRoundedRectButton, 5, 10, 2)TapAtPoint(IOSQuery[] query, TapPoint point = null, int tapCount = 1, int tapDownDelay = 10, int tapUpDelay = 10)
Performs a tap gesture at the specified location within the view specified by the query.
Supports views and subclasses of: UIView.
query (IOSQuery) - Identifies an element uniquely.
point (TapPoint) - (optional) The x, y position to tap in the view. If null, defaults to center point in view. If x, or y is negative, that value defaults to the center x, or y of the view.
tapCount (int) - (optional) How many times to tap. If null, defaults to 1.
tapDownDelay (int) - (optional) The amount of time tap down should last. Defaults to 10 milliseconds and cannot be less.
tapUpDelay (int) - (optional) The amount of time tap up should last, if multiple taps are used. Defaults to 10 milliseconds and cannot be less.
// This will perform tap on UIbutton on a specific point relative to the button. In this case the point to tap is with x=10 and y=10 offset.
TapPoint point = new TapPoint(10,10);
this.ActiveDevice.IOS.TapAtPoint(Elements.MyScreen1.UIRoundedRectButton, point);Dim point As New TapPoint(10, 10)
Me.ActiveDevice.IOS.TapAtPoint(Elements.MyScresen1.UIRoundedRectButton, point)Performs a tap gesture at the center-left of the view specified by the query.
Supports views and subclasses of: UIView.
query (IOSQuery) - Identifies an element uniquely.
//This will will tap exactly at the point between the left end and the exact center of the button
this.ActiveDevice.IOS.TapCenterLeft(Elements.MyScreen1.UIRoundedRectButton);Me.ActiveDevice.IOS.TapCenterLeft(Elements.MyScreen1.UIRoundedRectButton)Performs a tap gesture at the center-right of the view specified by the query.
Supports views and subclasses of: UIView.
query (IOSQuery) - Identifies an element uniquely.
// This will will tap exactly at the point between the right end and the exact center of the button
this.ActiveDevice.IOS.TapCenterRight(Elements.MyScreen1.UIRoundedRectButton);Me.ActiveDevice.IOS.TapCenterRight(Elements.MyScreen1.UIRoundedRectButton)Performs a tap-and-hold gesture at the center of the view specified by the query.
Supports views and subclasses of: UIView.
query (IOSQuery) - Identifies an element uniquely.
// This will tap the button and hold it tapped for 3 seconds
this.ActiveDevice.IOS.TapAndHold(Elements.MyScreen1.UIRoundedRectButton);Me.ActiveDevice.IOS.TapAndHold(Elements.MyScreen1.UIRoundedRectButton)Taps the view specified by the query, then types the specified text using the keyboard.
Supports views and subclasses of UITextField, UITextView, and UISearchBar.
query (IOSQuery) - Identifies an element uniquely.
text (string) - The text value to set on the view.
keyDelay (int) - The delay in milliseconds between each key stroke.
// This will type "Type Text" string in the text field with 20ms delay between key strokes
this.ActiveDevice.IOS.TypeText(Elements.MyScreen4.UITextField, "Type Text", 20);Me.ActiveDevice.IOS.TypeText(Elements.MyScreen4.UITextField, "Type Text", 20)Taps a subview at an index in the children of a view specified by the query.
Supports views and subclasses of UISegmentedControl, UITabBar, UIToolbar.
query (IOSQuery) - Identifies an element uniquely.
index (int) - The index of the view to tap.
// This will tap a subview of index 3 that is child of UIToolbar control
this.ActiveDevice.IOS.TapSubviewAtIndex(Elements.MyScreen6.UIToolbar, 3);Me.ActiveDevice.IOS.TapSubviewAtIndex(Elements.MyScreen6.UIToolbar, 3)Sets the toggle state of a view specified by the query.
Supports views and subclasses of: UISwitch.
query (IOSQuery) - Identifies an element uniquely.
toggleValue (bool) - The on/off true/false state to apply to the togglable view.
// Toggles the UISwitch button to true state
this.ActiveDevice.IOS.Toggle(Elements.MyScreen9.UISwitch, true);Me.ActiveDevice.IOS.Toggle(Elements.MyScreen9.UISwitch, true)Performs a rotate gesture at the specified location within the view specified by the query.
Supports views and subclasses of: UIView.
query (IOSQuery) - Identifies an element uniquely.
point (TapPoint) - The x, y position of origin to rotate around in the view.
angleInDegrees (int) - The angle in degrees to rotate.
// This will rotate 90 degrees the UIView with two fingers starting from 100 x, 100 y position realtive to the UIView
this.ActiveDevice.IOS.TwoFingerRotate(Elements.MyScreen9.UIView, new TapPoint(100,100), 90);Me.ActiveDevice.IOS.TwoFingerRotate(Elements.MyScreen9.UIView, new TapPoint(100,100), 90)Waits an arbitrary amount of time before continuing execution.
miliseconds (int) - The amount of time to wait in milliseconds.
// This will pause the execution and will wait for 10ms
this.ActiveDevice.IOS.Wait(10);Me.ActiveDevice.IOS.Wait(10)Executes elementExists command until the result matches the specified value or the timeout occurs.
Supports views and subclasses of: UIView.
query (IOSQuery) - Identifies an element uniquely.
exists (bool) - The expected command value.
checkInterval (int) - The interval between elementExists command calls.
timeout (int) - The overall number of milliseconds to wait for the element to exist.
// This will wait 1000 ms for UISwitch to exists and will check each 10 ms
this.ActiveDevice.IOS.WaitForElementExists(Elements.MyScreen9.UISwitch, true, 10, 1000);Me.ActiveDevice.IOS.WaitForElementExists(Elements.MyScreen9.UISwitch, true, 10, 1000)Executes elementVisible command until the result matches the specified value or the timeout occurs.
Supports views and subclasses of: UIView.
query (IOSQuery) - Identifies an element uniquely.
isVisible (bool) - The expected command value.
checkInterval (int) - The interval between elementVisible command calls.
timeout (int) - The overall number of milliseconds to wait for the element to get visible.
// This will wait 1000 ms for UISwitch to be visible and will check each 10 ms
this.ActiveDevice.IOS.WaitForElementVisible(Elements.MyScreen9.UISwitch, true, 10, 1000);Me.ActiveDevice.IOS.WaitForElementVisible(Elements.MyScreen9.UISwitch, true, 10, 1000)WaitForPropertyValue(IOSQuery[] query, string propertyName, string propertyValue, int checkInterval, int timeout)
Executes getPropertyValue command until the result matches the specified value or the timeout occurs.
Supports views and subclasses of: UIView.
query (IOSQuery) - Identifies an element uniquely.
propertyName (string) - The string name of the property.
propertyValue (string) - The expected property value as string.
checkInterval (int) - The interval between getPropertyValue command calls.
timeout (int) - The overall number of milliseconds to wait for the property value to match.
// This will wait 1000 ms for UILabel property text to become "test" and will check each 10 ms
this.ActiveDevice.IOS.WaitForPropertyValue(Elements.MyScreen1.UILabel, "text", "test", 10, 1000);Me.ActiveDevice.IOS.WaitForPropertyValue(Elements.MyScreen1.UILabel, "text", "test", 10, 1000)