Katalon Studio Recording Engine Extension

This document explains how to install Katalon Studio Recording Engine extension on web browsers for Katalon Web Recorder Plus's active browser and custom capability modes.

Install Katalon Studio Recording Engine extension

Follow these steps to install the extension on Chrome and Microsoft Edge:

1. Download the extension

• For Chrome: Install from Chrome Web Store.
• For Microsoft Edge: Install from Edge Add-ons.

2. Check for compatibility:

View your Katalon Studio Recording Engine extension's version.

Chrome

Go to chrome://extensions/ and search for Katalon Studio Recording Engine.

Microsoft Edge

Go to the Extensions page and search for Katalon Studio Recording Engine extension.

Refer to the following table for checking compatibility:

KSE version	Katalon Studio Recording Engine extension version
Before 10.2.4	prior to 1.0.8
10.3.0 to 10.4.3	1.0.13 onwards
11.0.0	1.0.14 onwards

note

As the Chrome Extension Marketplace only provides the latest version, opt for New Browser mode instead in case of incompatibility.

Configure browser profile for the recording extension

Once the extension is installed for a browser profile, specify the browser profile that has the extension before you record.

For Chrome

Specify a Chrome profile in Desired Capabilities:

1. Go to Project > Settings > Desired Capabilities > Chrome.
2. Add args, and set the type as List.

3. In the Value cell, click the ... button to open the List Properties Builder dialog.
4. Add the following values:

Type	Value
String	For Windows: user-data-dir=C:\Users\your_username\AppData\Local\Google\Chrome\User Data For macOS: user-data-dir=/Users/your_username/Library/Application Support/Google/Chrome
String	profile-directory=<your_profile_name>

5. Click Apply and Close. Your profile should now be applied.

Alternatively, select a Chrome profile in Preferences > Recorder > Specify Chrome Profile:

tip

Find your Chrome Profile quickly:

1. Open the browser profile with the extension.
2. Go to chrome://version on Microsoft Edge.
3. Check the value of Profile Path (E.g. C:\Users\your_username\AppData\Local\Google\Chrome\User Data\your_profile_name). This is the current profile's path. Go to this directory to view all of your profiles.

For Microsoft Edge

Specify a Microsoft Edge profile in Desired Capabilities:

1. Go to Project > Settings > Desired Capabilities > Edge.
2. Add ms:edgeOptions, and set the type as Dictionary.
3. In the Value cell, click the ... button to open the Dictionary Properties Builder dialog.

4. Add args, and set the type as List.
5. In the Value cell, click the ... button to open the List Properties Builder dialog.

6. Add the following values:

Type	Value
String	For Windows: user-data-dir=C:\Users\your_username\AppData\Local\Microsoft\Edge\User Data For macOS: user-data-dir=/Users/your_username/Library/Application Support/Microsoft Edge
String	profile-directory=<your_profile_name>

7. Click Apply and Close. Your profile should now be applied.

tip

Find your Microsoft Edge Profile quickly:

1. Open the browser profile with the extension.
2. Go to edge://version on Microsoft Edge.
3. Check the value of Profile Path (E.g. C:\Users\your_username\Library\Application Support\Microsoft Edge\Default). This is the current profile's path. Go to this directory to view all of your profiles.