Device Queries

Introduction

In general, Capabilities describes a series of key/value pairs that can customize or configure a Device or Browser session for testing to Selenium or Appium WebDriver.

Continuous Testing extends these capabilities and introduces Device Query capability. It is a special type of capability which describes one or more capabilities in a single query like input. 

The code snippet below is used to set Device Query using Selenium\Appium Java client bindings.

/**
 * Creates an Android Driver with Desired Capabilities.
 *
 */
protected void createDriverWithCapabilities() {
    LOGGER.info("Setting up Desired Capabilities");
    String accessKey = System.getenv(ENV_VAR_ACCESS_KEY);

    dc.setCapability(SeeTestCapabilityType.ACCESS_KEY, accessKey);
    dc.setCapability(MobileCapabilityType.PLATFORM_NAME,"iOS");
    String deviceQuery = String.format("@os=android and @dhmlocation='us-1'", "android");
    dc.setCapability(SeeTestCapabilityType.DEVICE_QUERY, deviceQuery);
    AppiumDriver driver = new AndroidDriver(SeeTestProperties.SEETEST_IO_APPIUM_URL, dc) :
}

Few important observations can be made from the code above,

1. Device Query is set using the key SeeTestCapabilityType.DEVICE_QUERY.
2. Multiple capabilities can be set in one single query input i.e. device query="@os=android and @location='US', as opposed to Appium capability which needs to be set one by one.
3. Property os overrides MobileCapabilityType.PLATFORM_NAME as they have the same meaning.

Supported Properties

Listed below are the properties or Key and Value which Device Query supports.

Syntax and Examples:

Device Query is written in XPATH Syntax i.e. @<propertyname>='<propertyvalue>' [ and @<propertyname>='<propertyvalue>' .....].

Device tags are added to query without @ character: tag='new_device'

Listed below are some examples