Understanding the Step Editor

With CheckView’s visual test editor, you have complete control over your test steps, including adding, reordering, and deleting steps. Access the editor by clicking the “Edit Steps” button on the individual test flow page or its test flow settings page.

Creating and Editing Tests

You can create tests using our prebuilt test flows when applicable and then refine them in the editor, or you can build tests from scratch using a custom test flow. The test editor presents each step as a block, providing options to add, remove, clone or move steps. Drag-and-drop functionality is available for easy reordering along with up and down ordering arrows. You can also easily delete steps using the trash can icon.

Test Editor Interface

Each test step includes a dropdown menu to select the action type, such as going to a URL, making an assertion, or assigning a value. When interacting with page elements, specify the target using CSS or XPath selectors. Some actions require extra input fields. For instance, the “Assign” action needs a value to assign, and the “Keypress” action allows you to specify keys like “Enter” or “Backspace.” You can read more about all available actions in the Understanding Step Actions doc.

Variables

Variables in the Step Editor are dynamic placeholders that instruct CheckView what data to use when filling out fields during a test. These variables allow you to standardize inputs across your test flows without manually entering values for every field. For example, a {{FirstName}} variable might automatically populate a first name field with “TestFirstName,” ensuring consistent and predictable test data. Variables can streamline testing by reducing manual adjustments and enabling more flexible, reusable test flows. You can read more about all available actions in the Variables doc.

Assertions

Assertions are a type of action that validate conditions on the page, ensuring your test outcomes are as expected. Common assertions include checking element presence, visibility, and text content. Assertions can wait for conditions to be met within a specified timeout, improving test reliability. You can read more about all available actions in the Understanding Step Actions doc.

Selectors

Selectors are instructions that help the CheckView bot locate and interact with specific elements on a webpage, such as buttons or input fields. Defined using CSS or XPath, selectors map to elements in the website’s structure (DOM) and ensure each test step targets the correct element. Accurate and stable selectors are essential, as changes to the website’s code can break them. Tools like browser developer tools or SelectorHub can help identify reliable selectors quickly. For added reliability, CheckView supports fallback selectors to handle dynamic changes. You can read more about all available actions in the Mastering Selectors in CheckView.

Optional Steps

When a step is marked as optional, CheckView will attempt to run the step as usual, but if it fails, it will not cause the test to fail. Instead, CheckView will simply highlight the step in yellow in the results and continue with the remaining steps.

This is useful when dealing with:

  • Elements that may not always appear (e.g., popups, upsell banners, seasonal messages)
  • Conditional UI behavior
  • Non-blocking visual elements (e.g., welcome messages, cookie banners already accepted)

How to Mark a Step as Optional

  1. Open the Step Editor: Navigate to the step you want to configure in your test suite.
  2. Locate the “Optional Step” Toggle: In the step’s settings panel, you’ll see a checkbox or toggle labeled Optional.
  3. Enable the Toggle: Check the box to mark the step as optional.

Import and Export Steps

To streamline test flow setup, CheckView now supports importing and exporting test steps using a standard JSON file format directly within the step editor. This feature is useful for backing up test flows, duplicating across environments, or sharing with teammates.

How to Export Test Steps

  1. Open the Step Editor: Navigate to the test suite you’d like to export and open the step editor.
  2. Access the Export/Import Panel: On the right-hand side of the step editor, locate the Export / Import Test Steps section.
  3. Select “Export Test Steps”: Ensure the Export Test Steps tab is selected, then click Export.
  4. Download the JSON File: A .json file will automatically download containing all current steps, selectors, and configurations from the test.

How to Import Test Steps

  1. Open the Step Editor: Navigate to the test suite where you want to import steps.
  2. Access the Export/Import Panel: On the right-hand side of the step editor, go to the Export / Import Test Steps section.
  3. Select “Import Test Steps”: Click the Import Test Steps tab to activate the import panel.
  4. Upload a JSON File: Choose the .json file containing your exported steps. After uploading, the steps will be automatically added to your current test suite. Note all existing steps in the step editor are replaced.
  5. Review & Save: Double-check the imported steps for accuracy. You can modify any selectors or step settings before saving your test.

Note: If you encounter issues importing steps from another test flow, first click “Save” on the original test flow before exporting. Then, use the newly exported file to import steps into the new test flow. This ensures all data is properly captured.

Docs