Editing tests

If your test is failing because a step doesn't work as intended or runs into an issue, mabl lets you edit your test's steps while keeping only the important info, including the URL, environment, application.

You can edit your tests by launching the mabl trainer or by using Quick Edit.

How to edit your tests

  1. Select "Tests" from the left-hand navigation.
  2. Click on the name of the test that you would like to edit.
23732373
  1. Click on the "Edit steps" button at the top right of the screen. You have two choices: Quick Edit, which lets you edit the test steps without opening the Trainer, and Launch Trainer, which opens the mabl Trainer.
23772377
  1. Choose either edit option.
  • Quick Edit: Choose this option if you want to make a small change that doesn't require interacting with the application under test.
  • Launch Trainer: Choose this option if you need to record (or re-record steps) that interact with the application, such as click steps or new assertions. When you open the Trainer, the test will start at the beginning. To get to a certain step in the test, click on the More actions menu for the step you want to edit and select Play through here.
  1. Edit the test as needed.
  2. Save or cancel your changes:
  • Save changes: click "Save." The Trainer will show a confirmation message. Then click "Close" to return to the mabl app.
  • Cancel changes: click "Close" at the bottom of the trainer. A modal will appear asking if you want to save your changes. Click "Discard."
598598

The confirmation message after clicking save. Also, note that the "Save" button is grayed out as no changes have been made since the previous save.

Even if you accidentally click "Close" when you've edited your test, mabl will prompt you with a modal asking if you'd like to save. You can discard the changes since the last save and return to the app, save the new changes and return to the app, or cancel and return back to the trainer.

🚧

Important information about editing tests

mabl does not place limits on how many users can edit a test at one time. Thus, it's important to coordinate with your team members to be sure new changes aren't saved over by another user. If you believe this has taken place, please contact mabl support in-app or at [email protected] so we can resolve this issue for you.

Quick edit: editing your tests in the mabl app

Selecting "Quick Edit" mode when editing a test pops the trainer into the mabl app itself, allowing you to edit most steps. You can edit almost everything, as long as it does not require interaction with the app under test. Because of this, creating new steps such as assertions and clicks, as well as replay, are not available in quick edit mode. Among the allowed features are: deleting steps, editing assertions, add waits, reordering steps, creating flows, and more.

Disabling steps

When troubleshooting a test, sometimes it is helpful to just disable certain steps rather than deleting them. Disabling steps can be useful in the following scenarios:

  • You want to validate that everything else works well in a test before deciding what to do with the disabled steps, which are skipped over during test runs.
  • The test interacts with a problematic area of the application that is being worked on by your development team. For example, you can disable specific clicks and assertions on the page until a fix has been shipped. Then, after the application has been updated, you can re-enable the disabled steps to maintain the previous level of test coverage.
  • You duplicated an existing test and are not sure which steps you want to keep or modify. In this case, you can disable most steps of the test while you work your way through the copied test. That way you can think of disabled steps as part of your to-do list of steps to review for that test.

You can disable/enable a step from the corresponding More actions menu in the mabl Trainer. You can also do so in bulk by selecting multiple steps and using the bulk actions menu that appears at the bottom of the Trainer. Hold Shift and Click to select multiple steps at once.

595595

More actions menu with an option to disable the step.

Drag-and-drop editing

When you're using the trainer, you can drag-and-drop your steps to reorder them in any way you'd like. This is great if you don't want to have to step all the way through your test to add a simple wait step, Javascript step, or similar.

Use caution when dragging and dropping steps to reorder them. Make sure you're on the correct page when recording steps. Adding steps to the test from the wrong page can cause the mabl Trainer to fail.

Editing steps using arrow keys

You can step through parts of your trained tests using the arrow keys, as long as the trainer is "in focus." When the trainer is in focus, it will display "edit" in the upper righthand side of the trainer.

Simply press the arrow keys up or down to move the magenta status bar throughout the trainer test. Be careful about adding steps in the wrong place, since clicks, entered text, and similar will still be recorded while you're stepping through your tests as long as you are not in replay mode.

By using the arrow keys to step through your test, you can add steps just about anywhere. You must be aware of when and where you are adding steps, as adding steps to the test from the wrong page can cause mabl to fail later on. Always be sure to be on the correct page when recording new steps.

Editing steps with replay

Since mabl allows you to replay each step of your test with the trainer, it is also used to step through which part of the test you would like to add your new step to.

Please see the gif below to understand how to properly edit and insert a step using replay.

900900

Watch the next chapter in the quick start video guide.


Did this page help you?