Troubleshoot Slow Object Recognition

If Ranorex Spy takes a long time to populate the element tree, track elements, or validate repository items, Ranorex may be processing more UI elements than necessary. Reduce the recognition scope and review the settings of the plugin used by your application.

Limit object recognition to the AUT

If Ranorex scans UI elements in every open application, object recognition may take longer. Use the whitelist to limit object recognition to the application under test (AUT).

To add the AUT to the whitelist:

1. In Ranorex Studio, go to View > Whitelist.
   
2. Under Running processes, select the AUT.
3. Select Add.
   
4. Select Apply whitelist.
5. Track or validate the element again.

For more information about configuring the whitelist, see Whitelisting.

Review the plugin settings

Some plugin settings increase the number of elements Ranorex processes. For example, Show all elements exposes additional elements and may affect recognition performance when those elements are not required.

First, identify the plugin used for the affected element:

1. Track the element and open it in Ranorex Spy.
2. Open the element’s Advanced Settings.
3. Locate the FlavorName attribute. This attribute identifies the plugin used to recognize the element.
   

Then, review the corresponding plugin settings:

1. In Ranorex Studio, open Settings.
2. Select Plugins.
3. Locate the plugin identified by the FlavorName attribute.
4. Review the settings that expose additional elements.
5. If Show all elements is enabled and the additional elements are not required for your test, disable it.
   
6. Restart the AUT and track or validate the element again.

Change only the settings for the plugin used by the affected application. Disabling options that your test requires may change which elements Ranorex can recognize.

Slow recognition in WPF applications

If object recognition is slow specifically in a WPF application running on modern .NET, additional WPF configuration may be required.

See Improve Slow Object Recognition in .NET WPF Applications.

If Ranorex recognizes the wrong WPF representation or does not recognize the required elements, see Troubleshoot Object Recognition in .NET WPF Applications.