Skip to main content

Creating a browser test

Eva Ferreira
  • Updated

This guide outlines how to create a new browser test.

To get started, click on the New test button in the left-hand navigation. If prompted, choose Browser test as the test type. A form to create a new browser test will appear.

new_browser_test.png

The new browser test creation form

At a minimum, you must define the test name and the application under test.

A full list of configurations that can be applied to a browser test follows:

Basic information

Test name

We recommend defining a naming convention for tests with other members of your workspace so that you can easily locate tests and understand what they do.

Test description

This option field is helpful if you want to give greater context or explanation for the test you are creating.

Test labels

Test labels are another optional setting; they offer a way to sort tests. They can also be used to trigger ad hoc runs from the mabl CLI.

Core settings

Indicate whether you'd like to train a test for desktop or mobile web.

Defining the application URL is required. There are three ways to do this:

  • Add to plan: When you add the test to an existing plan, the test uses the application, environment, and application URL associated with the plan.
  • Associate with an application: When you associate the test with an application, the test uses the associated application URL. For applications with multiple environments or application URLs, you must further specify which environment or application URL you want to use for training.
  • Start with a new URL: To test a URL that isn't associated with any application or plan in your workspace, check the box "Enter a starting URL to use to train your test" and enter the URL.

Testing viewport settings

  • Desktop: By default, the Trainer opens the application in a window that is 1000 x 800 pixels. Update the viewport settings if desired.
  • Mobile web: Select a device and orientation.

Optional configurations

Expand Optional configurations to associate the test with mabl credentials or a DataTable.

Authentication

Select a set of mabl credentials to use while training your test. The credentials dropdown does not appear for tests that are added to an existing plan. Instead, the test uses credentials associated at the plan level.

Check "Use auto-login flow" if you want to add an auto-login flow to the beginning of the test.

DataTables

Associate the test with a DataTable for training. 

Launch the Trainer

After filling out the browser test creation form, click on Create test to launch the mabl Trainer and record your test steps!

Related articles