Silk Mobile
Table of Contents (Homepage)
- Overview
- Setting Up
- Getting Started
- How To
- Connecting Devices And Emulators
- Preparing Applications For Testing
- Managing Applications
- Recording Tests
- Working With Test Commands
- Adding Commands To Your Scripts
- Object Commands
- Click
- ClickCoordinate
- ClickIn
- ClickOffset
- Drag
- ElementGetProperty
- ElementGetTableRowsCount
- ElementListPick
- ElementListSelect
- ElementListVisible
- ElementScrollToTableRow
- ElementSendText
- ElementSetProperty
- ElementSwipe
- ElementSwipeWhileNotFound
- GetAllValues
- GetElementCount
- GetElementCountIn
- GetTextIn
- IsElementBlank
- IsElementFound
- IsFoundIn
- LongClick
- RunNativeAPICall
- SendWhileNotFound
- VerifyElementFound
- VerifyElementNotFound
- VerifyIn
- WaitForElement
- WaitForElementToVanish
- GetCoordinateColor
- DragDrop
- Application Commands
- Device Commands
- Web (Hybrid) Specific Commands
- Utilities Commands
- Monitoring Commands
- Configuration Commands
- ExtractLanguageFiles
- SetDefaultClickDownTime
- SetDefaultTimeOut
- SetDefaultWebView
- SetDragStartDelay
- SetInKeyDelay
- SetKeyToKeyDelay
- SetLanguage
- SetLanguagePropertiesFile
- SetShowImageInReport
- SetShowPassImageInReport
- SetShowReport
- SetSpeed
- SetThrowExceptionOnFail
- SetWebAutoScroll
- StartStepsGroup
- StopStepsGroup
- TextFilter
- Miscellaneous Commands
- Controlling Element Identification Rules
- Editing Test Objects
- Executing Test Scripts
- Report Of Executed Test
- Working From Code Environment
- Continuous Integration
- Layout Verification Tests
- Use Device Vitals Monitors
- Troubleshooting
- Terminology
WaitForDevice
WaitForDevice(Device, Timeout)
|
|
|
|
Description
The command gives the ability to choose device for testing dynamically based on query of the devices properties.
It is mandatory to release the device and make it available for other future tests, use the ReleaseDevice command.
Parameters
-
Device: Search device query.
-
Timeout: Timeout in milliseconds to wait for an available device according to the search query.
Optional properties for queries:
-
device added: if device is available on the device list in the user's machine.
-
host: IP of the host machine in the SeeTestCloud configuration.
-
location: Location of the host machine as set in the SeeTestCloud configuration.
-
manufacture
-
model
-
name
-
os: Operating system.
-
remote: If device is connected through SeeTestCloud or not (values are true/false).
-
serialnumber: S/N of the device.
-
version: The device's operating system version (for example 4.1.2).
-
versionnumber: The device's operating system version number (for example 4.1).
-
category: The device category. Currently supported in android devices. possible values- 'WATCH', 'PHONE' or 'TABLET'.
Note: If the device is in the cloud, the command will make a reservation and use the device. However, if the device is already reserved, the command will not be able to reserve the device.
Usage
Command usage: Assigns a device to a test based on a device query. The query is written in XPath syntax.
Example Queries:
-
"@added='false' and @location='US' and @manufacture='Samsung' and @os='android' and @version='4.2.2' and @remote='true'"
-
"@added='false' and @location='UK' and @manufacture='apple' and @model='iphone/ipod(3/4/5)' and @os='ios' and @remote='false' and @versionnumber='7.0'"
Code Example
' Get information about all available devices in XML format.print MDriver("Driver").GetDevicesInformationDim deviceName' Wait for Windows Phone cloud device (30 seconds timeout)deviceName = MDriver("Driver").WaitForDevice ("@os='windows phone' AND @remote='true'", 30000)print "Following device was selected: " + deviceName' Perform some actions on deviceMDevice("name:=" + deviceName).OpenMDevice("name:=" + deviceName).Swipe "Right", 0wait(3)MDevice("name:=" + deviceName).Swipe "Left", 0' Release the device from cloud after using it, but do not remove from device manager.MDriver("Driver").ReleaseDevice deviceName, false' Additional examples for WaitForDevice usagedeviceName = MDriver("Driver").WaitForDevice ("@serialnumber='00000011-07ad-5c10-0000-000000000000'", 30000)deviceName = MDriver("Driver").WaitForDevice ("@os='android'", 30000)deviceName = MDriver("Driver").WaitForDevice ("@name='Nokia Lumia 820 (RM-825)'", 30000)