Running a Web UI test
To verify that a web application works as designed, run the test in a browser. Optionally, you can run the test in more than one browser at a time to speed up your test effort. Before running the test, you can choose to use a specific browser profile for the test.
Before you begin
- You must have recorded a Web UI test. See Recording a Web UI test.
- Read and completed the tasks mentioned in Prerequisites to running Web UI tests if they apply to the test that you want to run.
- If the packaged drivers for the Google Chrome, Microsoft Edge, and Opera browsers are
not compatible with the browsers installed on your computer, during the playback, a link
is provided in the Run Configuration dialog. You must click the
link to install the appropriate driver and only then continue with the playback of
tests.Important: If you do not resolve the driver incompatibility with the browser, and continue with the test run, the following events can occur.
- The incompatible driver is started in the background, but the browser is not visible to you.
- The test fails to run on the selected browser.
- You cannot start another test run as the incompatible driver still runs in the background.
To resove the issue, you must manually end all instances of the browser drivers that run in the backround, and then install the compatible driver as indicated in the Run Configuration dialog before you attempt another test run.
When you play back Web UI tests on a remote computer, you can choose to automatically resolve the browser and driver incompatibility of the Google Chrome, Edge, and Opera browsers by selecting the Fix the browser driver incompatibility checkbox.
Only those web browsers that are installed on your computer and supported by the Web UI extension are displayed in the list. To run a web test on a mobile device or emulator, the device must be connected and must be in the passive mode.
About this task
You can run a Web UI test in the same web browser that was used for the recording or run the test in other web browsers. You can even run a Web UI test in several browsers simultaneously. You can also run the test as part of keyword execution from IBM® Rational® Quality Manager, as part of compound test, or from the Command Line Interface (CLI).
Procedure
- Double-click the test to open it from the Test Navigator view.
-
Click Run Test to run an individual test or Run
Compound Test to run a compound test in the Test editor.
The Run Configuration dialog is displayed.
-
Select the run configuration options as required for the test run.
The options are described in the following table:
Option Action Run on several devices and browsers in parallel Select this checkbox to view and select the devices and browsers on which to run the test. Restriction: Use of multiple displays (monitors) on Mac operating systems to play back recorded tests on any supported browser is not supported.Run using Click the displayed browser name in this column to select the web browser on which to run the test. Collect data to update test steps Select this checkbox if it is cleared to apply guided healing. Automatically update the test at end of the playback Select this checkbox to apply self-healing if you have selected Collect data to update test steps option. -
Click Next.
The Advanced playback options page is displayed.
-
Select the advanced playback options as required for the test run.
The options are described in the following table:
Option Action Clear browser data Select this checkbox to optimize the performance of web browsers. Private Mode Select this checkbox to run tests in the private mode. Launch browser with arguments Select this checkbox to specify the arguments to be used by the browser, and then enter the arguments in the text box. You can enter multiple arguments separated by a semicolon. For example, -<param1>;-<parama2>
-
Click Next.
The Performance Measurement page is displayed. The options on this page are applicable only for mobile tests and they are disabled for Web UI tests.
-
Click Finish.
The selected web browser opens and the test is played back. Do not perform any action on the web browser while the test is playing back. The statistical and live reports show the live data as the test is played back.