Skip to main content

Manage Mobile Test Objects

In version 7.6, Katalon Studio fully support selector strategies supported by Appium except for Android Data Matcher.

In Manual View

Create a Mobile Object

We recommend creating a Mobile object by using Katalon Mobile Spy since the object locators are captured automatically for detecting objects during test execution.

You can also create an object in Object Repository by right-click on Object Repository and selecting New > Mobile Object.



The most important property of an object is its locator strategy and value. The locator should be unique in detecting that object. Select a locator strategy among the provided option and enter a locator.

Katalon Studio 7.6+ fully supports selector strategies supported by Appium except for Android Data Matcher.



Validate Test Object on AUT

You can add test objects to Mobile Object Spy to verify if the object can be detected successfully in the application under test. Refer to Spy Mobile Utility for more details regarding how to validate captured objects against the application under test.

To add an object to Mobile Object Spy, right-click on the item to open its context menu and select the option.



Add an object's property

You can add multiple object properties to the Object's Properties table. Please note that object properties cannot share the same name in an object.

  1. In the Object's Properties panel, click Add.
  2. In the displayed Add property dialog, specify the required information:
  • Name: The object property's name. You can select one of the provided options (class, css, id, name, title, xpath) or enter a name manually.
  • Match condition: The condition is used for detecting the target object during execution.
  • Value: The value that completes a match condition.

The new property is added to the properties list as configured above. You can also change the properties' values here.

In Script View

Script View allows defining and handling Test Objects programmatically. The following is a usage example demonstrating how to do that:



import static com.kms.katalon.core.testobject.ObjectRepository.findTestObject
import com.kms.katalon.core.testobject.MobileTestObject
import com.kms.katalon.core.testobject.MobileTestObject.MobileLocatorStrategy

// Find an object which was defined already in Object Repository
myPredefinedObject = findTestObject('android.widget.TextView - App')

// Create a new mobile object programmatically
MobileTestObject mobileTestObject = new MobileTestObject("TestObjectID")
mobileTestObject.setMobileLocatorStrategy(MobileLocatorStrategy.XPATH)
mobileTestObject.setMobileLocator("//android.widget.TextView[(text() = 'App' or . = 'App')]")