Recording a Web UI test by using a running browser instance

You can create a Web UI test of a web application from the UI Test perspective using a browser that is already running locally. For example, if you have already recorded some part of a web application, you can go back at a later time to resume the recording. Support is provided for Chrome and Firefox on Windows and Linux computers and for Safari, Chrome and Firefox on Macintosh computers. Internet Explorer is not supported.

Before you begin

Install the Web UI extensions for the browsers that you plan to use for testing. For instructions, see Enabling Google Chrome for Web UI testing, Enabling Mozilla Firefox for Web UI testing, Enabling Apple Safari for Web UI tests on macOS, and Enabling Microsoft Edge for Web UI testing.
When recording a test, wait for each page to load completely. This waiting time does not affect performance results, because you can remove extra waiting time (think time) when you play back the test.
Do not change any browser preferences, including JavaScript settings. Recording and playing back Web UI scripts in a browser requires that JavaScript be enabled.
For Mozilla Firefox®, clear the cache before you start the Firefox® browser so that the browser extension can run and record the web applications.
To record a test that emulates a web application on a mobile device, see Recording a test with Google Chrome Device Mode.

Procedure

Start a supported browser session and type the URL of the web application to test.
Go to the UI Test perspective.
Click New > Test From Recording. Alternatively, on the toolbar, click the New Test From Recording icon .
Click Create a test from a new recording. Select Web UI Test. If you are recording sensitive data, click Recording Encryption Level and select the encryption level to record. Click Next.
Optional: If you did not create a test project earlier, click the Create the parent folder icon to create a test project. For more information, see Creating project.
Type a name for the test, and then click Next.
The Select Client Application page is displayed.
Select Running browser instance, and then click Next.
Select the web application to test from the list of running browser instances, and then click Finish.
Return to the browser and record the test.
After you finish the user tasks in the browser, stop the recorder by clicking the Stop icon in the Recording Control view.

After you stop the recorder, the test is generated from the recording.
Optional: Open the test for editing.

What to do next

When the test is generated, you can edit it in the test editor. For information, see Modification of Web UI tests.

To create variable data for the test, you can use the dataset candidates suggested by the workbench when you first open the generated test. For more information, see Viewing dataset candidates when you open a test.