How to Use the Visual Editor

Learn how to capture UI elements, such as buttons, text fields, and text.

Overview

Using the Visual Editor, you can create tests without any coding. A Visual Editor test is comprised of steps. Instead of plain-text instructions, you specify actions such as Click and Navigate. These steps tell the application how to interact with the page. For information on how to create a Visual Editor test, see this article.

There are five areas in the editor:

  • Test Information
  • Steps and Actions
  • Settings
  • Save & Run
  • Virtual Machine (VM)
1203

The Visual Editor.

Test Information

This area provides details on:

  • Test Name
  • Last Run Status
  • Last Modified by

Note: You can change the test name anytime by clicking the name and updating.

Steps and Actions

This is where you create your tests. As steps are added or changed, click the Preview Actions button to execute them in the VM. See the following articles for more information:

Test Options

These icons provide direct access to actions and functionality to support test creation and management:

  • Question Mark. Provides access to the Rainforest Help Center.
  • Clock. Shows a test’s run history.
  • Pencil and Ruler. If enabled, requests a test rewrite.
  • Double Boxes. Duplicates the test. All information and settings are copied except for run history.
  • Gear. Opens the Settings page. For more information, see the Visual Editor Test Settings Glossary.

Virtual Machine

The Virtual Machine (VM) provides a way to interact directly with the site being tested. The VM is used to capture UI elements, such as buttons, text fields, and text.

  • By default, the VM location is the USA. For more information, see our geolocations article.
  • The VM automatically loads the test’s default platform.
  • Update the VM to a new platform on the Settings page. For more information, see the Visual Editor Test Settings Glossary.
  • To reload the VM, click "Reset Machine" (under the "Run Test" button).

📘

All virtual machines are set in the UTC time zone during preview and testing.

1409

Resetting the VM after changing the platform.

Resetting Test Data and the Virtual Machine

Some test data requires you to reset it before it can be reused. You can do this by resetting the Virtual Machine.

  1. Click Reset Machine in the upper right-hand corner of the screen.
  2. Click Reset Machine to reset the environment as well. For more information, see Using Test Data.

Virtual Machine Console

Use the Virtual Machine Console to see detailed information for debugging. To toggle the console open and closed:

  1. Click the Console icon in the upper right-hand corner next to the Reset Machine button.
  2. The Virtual Machine Console appears below and provides detailed information as the test executes.
  3. Close the Virtual Machine Console by clicking the Close Console button.
1406

Virtual Machine Console


If you have any questions, reach out to us at [email protected].