Choose a Web Client Application

This is the first page that appears in the Create a New Recording wizard after the Choose a recorder page.

The web client application is the program that appears when recording begins. You perform actions within the web client application, such as visiting web pages, entering data, and clicking links as a real user would do when interacting with the system under test (usually a website). The HTTP(S) requests sent and responses received as you perform these actions are recorded by the Eggplant Performance Proxy Recorder.

The options on this page will be populated with the values that you used the last time the Create a New Recording wizard was successfully completed.

Click Proxy Recorder Settings to change Proxy Recorder Settings.

Choose an Application

The Application drop-down list gives a choice of:

• common browsers (if installed)
• user-defined applications
• the option to record without launching an application (if, for example, the application to record is already running)
• the option to record from a mobile device or external device

note

When a browser is launched alongside the Eggplant Proxy Recorder, it opens with a blank page rather than the browser's default home page to avoid recording unnecessary HTTP requests. You can provide a URL in the Command line arguments field to make the browser navigate to a specific URL as it launches.

The Launch transaction name field contains the name of the transaction that will be started automatically when the Eggplant Proxy Recorder begins recording.

The option to Launch in private mode (recommended) is available for any browser. It is recommended to launch the browser in private mode so that requests for resources that are cached are not omitted. This behavior would affect the requests sent by a virtual user during a test. Browsing in private (or incognito) mode doesn't use existing cookies or save new cookies after the browsing session.

User-Defined Applications

To define an application, follow these steps:

1. Select New Application in the Application list.

2. Enter the Application Name in the pop-up window, then click OK.

3. Click Browse next to the Application executable field, then navigate to the executable (.exe) file that should be launched alongside the Eggplant Proxy Recorder.

4. You can optionally provide a Working folder if the application needs to be running in a particular directory, and Command line arguments to pass to the application.

The new user-defined application appears in the Application drop-down list and will be saved for use in other recordings within the same Project.

To remove a user-defined application, select it in the Application list, then click Remove.

Recording from Mobile or External Devices

When you select this option from the drop-down list, you'll need to configure your device to communicate with the Controller machine. The mobile device needs to have the Controller act as its proxy server communicating over port 9090.

With the Record mobile or other external device option selected, the Notes section displays the hostnames/IP addresses associated with the Controller machine to help make the configuration settings on the external device.

Recording from an Android Device

The procedure might differ from device to device; please check the user guide for your particular device. However, the steps should be similar to the following:

1. In the Settings app, navigate to Wi-Fi.

   

2. Tap and hold the wireless network you're connected to, then tap Modify network config.

   

3. Select the Show advanced options check box.

4. Set Proxy settings to Manual.

5. Enter the IP address or hostname displayed on the Choose a web client application to launch wizard page.

6. Enter 9090 as the port, unless you have changed the Port option in Proxy Recorder Settings.

   

7. Tap Save.

8. Click Next in the Create a New Recording wizard, which opens the Record mobile or other external device page. If you haven't installed a root certificate on the device, you'll need to do so before you can record encrypted HTTPS traffic with the proxy recorder. Follow the instructions in Installing the Root Certificate on Mobile Devices.

9. Click Next, then click Start recording.

10. Use the browser on your Android device to perform the website navigation to be recorded.

11. When you have finished, follow the instructions for recording with the Web Proxy Recorder.

Remember to reset the proxy settings on your Android device after recording; otherwise, the browser might not connect.

Recording from an iOS Device

The procedure might differ from device to device; please check the user guide for your particular device. However, the steps should be similar to the following:

1. In the Settings app, tap Wi-Fi.

   

2. Tap the wireless network you're connected to.

3. Scroll down to the HTTP PROXY section, and tap Manual.

4. In the Server box, enter the IP address or hostname displayed on the Choose a web client application to launch wizard page.

5. Enter 9090 as the port, unless you have changed the Port option in Proxy Recorder Settings.

   

6. Click Next in the Create a New Recording wizard, which opens the Record mobile or other external device page. If you haven't installed a root certificate on the device, you'll need to do so before you can record encrypted HTTPS traffic with the proxy recorder. Follow the instructions in Installing the Root Certificate on Mobile Devices.

7. Click Next, then click Start recording.

8. Use the browser on your iOS device to perform the website navigation to be recorded.

9. When you have finished, follow the instructions for recording with the Web Proxy Recorder.

Remember to reset the proxy settings on your iOS device after recording; otherwise, the browser might not connect.