Applies to TestComplete 14.30, last modified on November 21, 2019

About Support

TestComplete can recognize iOS AlertView controls in iOS applications. It provides special properties and methods that let you retrieve the controls data and simulate user actions on the controls (see below).


In order for TestComplete to be able to work with iOS AlertView controls, the following requirements must be met:

  • You must have an active license for the TestComplete Mobile module.

  • Your tested iOS application, the devices and the computer where TestComplete runs must be configured in a special way as it is described in the topics of the Preparing Applications, Devices, and Test Computers for iOS Testing section.

  • The control’s class name must be specified in the iOS Controls | Alert view group of your project’s Object Mapping options. By default, this group contains the following item:

    • UIAlertView

    To command TestComplete to recognize instances of the specified class’s descendants as iOS AlertView controls, select the Derived Classes check box next to the control’s class name.

    You can also command the test engine to recognize custom controls as iOS AlertView controls. See below for information about this.

  • Support for the iOS AlertView controls is implemented by the iOS Support plugin. This plugin is installed and enabled automatically as part of the TestComplete Mobile module.

    If you experience issues when working with the controls, select File > Install Extensions from the TestComplete main menu and check whether the plugin is active. (You can find the plugin in the Mobile group.) If the plugin is not available, run the TestComplete installation in the Repair mode.

Recognizing Custom Controls

To command TestComplete to recognize your custom controls as iOS AlertView controls, open your project’s Object Mapping options and add the control’s class name to the iOS Controls | Alert view group. The class name is specified by the control’s ObjectClassName property. You can get the property value in the Object Browser panel. You can also choose the needed control from screen. For detailed information, see Object Mapping. Once the control is mapped, it gets all the properties, methods and actions specific to the iOS AlertView control.

If the specified custom control does not fit the control’s type, then it may not properly respond to commands that TestComplete sends, so recording or playing back user actions over the tested control will cause errors.


When testing iOS AlertView controls, you can use properties and methods specific to these controls, as well as properties and methods that TestComplete applies to tested objects, onscreen objects and window objects. For the full list of available properties and methods, see the following topics:

See Also

List of iOS Controls
Testing iOS Applications
Working With iOS Alert View Controls

Highlight search results