Record a RealBrowser user path
Recording is the fastest way to create a RealBrowser test. Just use your application normally, and Tricentis NeoLoad captures every click, keystroke, and navigation. Each interaction becomes an action you can replay at scale.
Start recording
Select Start recording in the toolbar or go to Record > Start RealBrowser Recording. In the recorder launcher, open the RealBrowser tab and select Enable RealBrowser recording.
RealBrowser recording works standalone, so enabling it disables other recorder types.
Configure recording settings
Before you start recording, configure the browser settings. These settings carry over to the OpenBrowser action, so your test runs exactly like your recording.
General settings
These settings control how the browser looks and behaves:
| Setting | Description | Format | Default |
|---|---|---|---|
| Resolution |
The browser launch resolution. Use this to test responsive applications where display changes based on browser dimensions. The Maximized value lets the browser take the full screen width, but the actual value added to the OpenBrowser action is evaluated directly in the browser. |
Width x Height | 1920 x 1080 |
| Locale |
The browser launch locale. Some websites detect the browser locale and display content in the appropriate language. Use ISO-3166 Country Codes and ISO-639 Language Codes. Example: en-EN, fr-FR. |
String | Default |
| Time zone |
The browser launch timezone. Use this for applications whose content depends on timezone data. Use a TZ database name from the TZ database. Example: Europe/Paris. |
String | Default |
Advanced settings
These settings give you more control over recording behavior:
| Setting | Description | Format | Default |
|---|---|---|---|
| Use IDs in recorded selectors | Includes the ID attribute of targeted elements in detected selectors. Disable this when the target application has dynamic IDs that change between page refreshes. | Boolean | true |
| Ignore HTTPS errors | Ignores any HTTPS/certificate errors. Use this to record apps in development behind a self-signed certificate. | Boolean | false |
| Recorded selectors type | The type of selectors recorded in a session. Choose between CSS and XPath. | Constants | CSS |
| User Agent | The user agent sent with each browser request during recording. | String | Empty (uses original browser user agent) |
| Headers | Headers sent with each browser request during recording. Format: name=value. Specify a host to limit headers to specific servers. | String | Empty |
| Geolocation | Change browser geolocation with specific coordinates. Format: latitude, longitude, accuracy (decimal format). | Decimal values, semicolon-separated | Empty (uses original browser geolocation) |
| Bypass CSP | Bypass page's Content-Security-Policy. Set this to true to bypass all content security policies in the browser context. | Boolean | false |
| Permissions | Add permissions in the current browser context. Values can be: midi, midi-sysex, notification, camera, microphone, background-sync, ambient-light-sensor, accelerometer, gyroscope, magnetometer, accessibility-events, clipboard-read, clipboard-write, payment-handler. | Comma-separated strings | Empty |
| Ignore Screenshots | Disable all screenshots taken while recording. | Boolean | false |
Record your application
Select OK to launch the browser. You'll see the Tricentis NeoLoad Recording Welcome page. From here, navigate to your application or pick a recent URL.
Now just use your application. Click buttons, fill forms, navigate pages. Everything you do becomes an action in your user path.
The recording toolbar gives you control:
-
Pause when you need to do something you don't want recorded.
-
Resume to continue recording.
-
Stop when you're done.
-
Container to change where actions are recorded.
-
Transaction to group actions into logical steps.
-
MouseOver to capture hover actions.
To record mouse over actions:
-
Select MouseOver from the record toolbar.
-
Right-click on the webpage where you want to add a mouse over action.
-
Continue the user path in Tricentis NeoLoad.
-
To disable mouse over mode, select the MouseOver action icon on the record bar.
To record wait selector actions:
-
Select the WaitSelector action icon on the record toolbar.
-
Right-click on the webpage where you want to add a WaitSelector action.
-
Continue the user path in Tricentis NeoLoad.
-
To disable WaitSelector mode, select the WaitSelector action icon on the record bar.
Post-recording wizard
When you stop recording, the Post-recording Wizard helps you polish your user path:
-
Redesign the user path: Adds error handling and makes sure browsers close properly. We recommend this for tests you'll run at scale.
-
Override recorded think-times: Adjusts the pauses between actions.
Want to skip the wizard? Select Finish.
Add steps with Record Here
Need to add steps to an existing user path? Use Record Here:
-
Right-click the action where you want to insert new steps.
-
Select Record Here.
Tricentis NeoLoad plays your user path up to that point, then starts recording. New actions go into the Inserted Content container.
To include think times during replay, select Enable think time when replaying browser actions in the Record panel.
Use a proxy
RealBrowser uses the same proxy settings for recording and playback. During recording, it prefers HTTPS and falls back to HTTP.
Use custom attributes for selectors
Does your application use custom attributes like data-test-id to identify elements? You can tell the recorder to use them.
Add this line to your controller_user.properties file:
realBrowser.customAttributeSelectors=data-testid
The file is located at:
-
Windows: C:\Users\${user}\AppData\Roaming\Neotys\NeoLoad\${neoload.version}\conf
-
Linux: /home/${user}/.neotys/neoload/${neoload.version}/conf/
For multiple attributes, separate them with semicolons: attribute1;attribute2
What the recorder doesn't capture
Some actions need extra steps:
-
MouseOver: Hovering isn't captured automatically. Enable it from the toolbar when you need it.
-
Scroll: Most actions auto-scroll, but for infinite scrolling, add Scroll actions manually in design.
-
Back/Forward buttons: These don't record. Add them in design using the button parameter.
-
HTTP authentication prompts: Set credentials in the Post-recording Wizard or see Configure RealBrowser authentication.
Note that each tab records only one direct navigation. Other page changes come from clicks and keystrokes.