When you create a new browser test in the mabl app - New test > Browser test - there are two ways to configure high-level test settings:
- Agentic test creation - build a test outline with the mabl agent, then click on Next steps to configure test settings.
- Manual test creation - click on Create manually instead and configure test settings
New to mabl?
If you’re new to mabl and want more guidance on training tests against your web app, check out the article on getting started with browser tests.
The new browser test creation form
At a minimum, you must define the test name and the application under test. Read on for the full list of configurations that you can apply to a new browser test:
Basic information
Give your test a name. Optionally, you may add a description and labels.
As a best practice, we recommend working with your team to define naming conventions for tests so that you can easily locate tests and understand what they do. Use descriptions and labels to add clarity and structure to your workspace.
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 1080 x 1440 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.
Build approach
If you created a test plan with the mabl agent, the test creation form also includes a Build approach section:
- Cloud - the agent builds out the test in the mabl cloud. Monitor the test authoring session from the agents page.
- Local - the agent builds out the test in the mabl Trainer.
Create your test
After filling out the browser test creation form, click on Create test to launch the mabl Trainer and start your cloud-based authoring session!