Share this page

# Record a script with the Web Recorder

The Web Recorder enables you to record your business process into a HAR file, and convert it into an executable Vuser script.

In this topic:

## About the Web Recorder

The Web Recorder enables you to record events on your web browser into a HAR file, and then convert the file to an executable Vuser script. This can be useful if your environment does not allow you to record on a web browser, or if your company's security policy blocks the standard VuGen recorder.

The Web Recorder installs a Chrome web browser extension to record the HAR file. You record the HAR file, and then use the VuGen traffic analyzer to generate a Vuser script. For details on how to install the Web Recorder browser extension, see below.

The extension is supported for the following protocols:

- Java over HTTP

- SAP - Web

- Siebel - Web

- Web - HTTP/HTML

## Manually install the browser extension

You can manually install the standalone version of the Web Recorder browser extension, and use it with your Chrome browser to generate HAR files. The extension can be installed permanently on the browser, or loaded for the current browser instance only.

To install the browser extension:

1. In the VuGen installation package, locate the archive file: DVD\Additional Components\ChromeRecorder\ChromeRecorder.zip

Copy the file to a local folder and extract its contents.

2. Install the extension:

   - To permanently install the extension on Chrome, open the Chrome manage extensions page in Developer mode. Load the unpacked extension.

   - To load the extension for the current browser instance, run the following from the command line:

   chrome.exe --load-extension=<path-to-extension>

3. (Optional) If you want to use the browser extension in Incognito mode:

   1. On the Chrome manage extensions page, locate the Web Recorder and click Details.

   2. Enable the Allow in Incognito option.

## Record a HAR file with the browser extension

You use the Web Recorder extension to record events in the Chrome browser, and generate a HAR file.

The HAR file can be converted into an executable Vuser script in VuGen.

To record a HAR file using the browser extension:

1. After installing the Web Recorder on the machine, open it from the Chrome browser extensions list. The recording window opens.

2. Click Start Recording.
3. In your Chrome browser, open a new tab. Enter a URL or browse to a web site.

4. Within the browser, start performing the business processes that you want to record.

   Use the recording window buttons to add actions, transactions, rendezvous points, and comments. For details on UI elements, see Web Recorder recording window.

5. Click Stop Recording. In the resulting popup, enter a name for the HAR script file and click OK.

   The <script-name>.har file is saved in your Downloads folder.

6. To convert the HAR file into a VuGen script, see Create a script from a captured traffic file.

## Web Recorder recording window

The Web Recorder recording window enables you to control the recording, and provides access to common commands used for Vuser scripts.

User interface elements are described below:

UI Element | Description
--- | ---
Start Recording/Continue Recording | Starts recording, or resumes after recording was paused.
Pause Recording | Pauses the recording.
Stop Recording | Stops recording and starts generation of the HAR file.
Capture Response Body | When selected, the entire body is captured from the HTTP response.
Start Transaction | Enables you to mark the beginning of a transaction and specify the transaction name. For details, see Using transactions.
End Transaction | Enables you to end the transaction listed in the transaction box.
<Transaction box> | Opens a dropdown, allowing you to select the transaction you want to end. This list is displayed when one or more transactions are active.
Add/Switch to action | Enables you to specify a new action into which you want to record. The name of the added action is displayed to the left of the Add/Switch to action button.
Insert Rendezvous | Enables you to insert a Rendezvous point into your script. For details, see Insert rendezvous points.
Insert Comment | Enables you to insert a comment into your script.
Capture HTTP Auth | Instructs the recorder to capture HTTP authentication. If you select this option, the extension will record the HTTP authentication with the username and password, and add a web_set_user step to the script. If you do not select this option, the extension will only record requests and responses without the login page. Note: When enabled, the unencrypted password will be recorded. Do not enable this feature if your company has a security policy for storing passwords.

## Known issues

The following notes and limitations apply when recording with the Chrome browser recording extension:

- When the Web Recorder is in use, you may see messages about the operation of the extension. You must allow the extension functionality to continue, so that it does not block recording.

  For example:

  - Web Recorder started debugging the browser: Leave the debugger running, do not cancel.

  - This page was changed by the Web Recorder extension: Select to keep it, do not change it back.

- The first blank page opened with the browser will not be recorded. Open a new tab to begin recording events.

- Subsequent browser tabs must be opened manually to be recorded by the Web Recorder. To open links in a new tab, copy the link address, open a new tab, and paste in the URL.

- WebSocket events are not supported.

- Authorization headers are not recorded, since they are filtered out by Chrome.

- Certain HTTP/HTTPS events, as defined by Chrome, may not contain a response body.

- If you enter credentials multiple times during recording, they will be added to the script as separate web_set_user calls. As a workaround, manually remove the incorrect or unnecessary calls to web_set_user from the script.

## See also

- Start Recording dialog box
- Create a PCAP file

https://admhelp.microfocus.com VuGen,Professional Performance Engineering,Performance Engineering for Developers 8942
Tips to improve your search results... OpenText™ Virtual User Generator Help Center OpenText™ VuGen Help 26.1-26.3 All View Local Help Center View Online Help Center Version: