Whitelisting

When identifying UI elements, Ranorex Studio and its components scan all running processes on your computer by default. With whitelisting, you can focus Ranorex Studio on only the processes relevant to your test, with these advantages:

• It increases performance during test recording, test execution, and in Ranorex Spy.
• It helps you create clean recordings since you can interact only with whitelisted processes.

Hint: Plan which processes will be part of your test and add them to your whitelist.

1. In Ranorex Studio, go to View > Whitelist. The whitelist pad opens.

2. Click Edit whitelist… if your whitelist is empty or click the whitelist icon in the top right of the pad.

3. The edit window appears. In it:

   1. Add processes to the whitelist or remove them using the buttons.

   2. If a process isn’t listed on the left, click Add process… to browse to it and add it directly.

   3. Click Advanced… to open a dialog where you can paste a list of process names or specify a range of process names with a regex statement.
      

   4. When you complete the previous steps, click Apply whitelist. Ranorex Studio and its components now recognize UI elements only in the whitelisted processes.

Note: Endpoints are not affected by whitelisting, and so will still appear in Spy.

Reference: Find out more about endpoints in Getting started

Result

1. Spy browser window without whitelisting.

2. Spy browser window with active whitelisting and the Ranorex Studio Demo Application in the whitelist.