Using loops

With loops, you can repeat a sequence of test steps a set number of times within a single test run. Loops are useful when your test needs to perform the same action for each item in a list, such as selecting every option in a dropdown, adding multiple items to a cart, or checking each row in a table. This article explains how create and work with loops in your tests, including how to:

• Create a loop
• Loop through items on a page
• Use the loop index variable
• Exit a loop early
• Replay loops in the Trainer
• Review loop output in test runs

Create a loop

In the mabl Trainer, take the following steps to create a loop:

1. Click on + (Add step) > Loops.
2. Loops are saved as flows in mabl. Give the flow a name.
3. Click on the Looping tab.
4. Select Loop using a fixed number or, to set the number dynamically, Loop using a variable. The value must be a valid number between 2 and 500. You cannot set a flow to loop using a flow parameter.
5. Click OK.
6. With the Trainer cursor inside the Start flow and End flow steps, record the test steps that you would like to repeat in the loop.

Alternatively, you may convert an existing set of test steps into a loop. Create a loop, then drag and drop the Start flow and End flow steps so that they wrap around the test steps you want to repeat in the loop.

When you configure a looping value for a flow, the settings are not applied to other instances of the flow. We recommend using a naming convention in your workspace to identify flows that are intended to function as a loop.

Loop through items on the page

A common use case for loops is repeating steps for each item in a dynamic list, such as dropdown options, table rows, or menu items. To set this up:

1. Count the items. Use Find Elements to locate the elements you want to loop through. Create a variable from the element count.
2. Create a loop using the count variable. Follow the steps above to create a loop and select Loop using a variable, choosing the count variable you just created.
3. Create a zero-based index variable. Inside the loop, create a variable called index with the value {{@run.loop_index-1}}. This is necessary because run.loop_index starts at 1, but element lists are zero-indexed. See the section on using the loop index for more detail.
4. Target each item using the index. Use Find Elements with an XPath or CSS selector that incorporates {{@index}} to target the current item. For example, (//li[@role="option"])[{{@index}}].
5. Perform your action. Click the element, assert on its text, create a variable from its properties, or record any other steps you need to repeat for each item.

If you need to extract text or properties from elements into a list, you can use the snippet generator to write a JavaScript snippet that collects the values you need.

Use the loop index variable

Within a loop, mabl adds a special, read-only variable called run.loop_index, which starts at 1. To access the loop index, use mabl variable syntax: {{@run.loop_index}}.

Access loop index in snippets

In snippets, you can access the loop index in one of the following ways:

• Add {{@run.loop_index}} as a snippet parameter.
• Access the loop index from the mablInputs object: mablInputs.variables.web.runtime.flow_run_ordinal_index

Exit a loop early

To create a de facto while loop that exits when a specific condition is met, follow these steps:

1. Create a variable and assign it a number as a value.
2. Create a flow that loops using the variable you just created.
3. In the flow, add an IF step that asserts the conditions in which the loop should exit.
4. In the IF step, add a variable step that creates a new variable with the same name as the looping variable, and set the value to 0.
5. Add an ELSE step.
6. In the ELSE step, record the steps that the loop should do if the break conditions are not met.

In the example below, the variable total is initialized to 500. In the loop, as soon as the number of checked checkboxes reaches five, the value of total changes to 0. Updating the value of the looping variable causes the loop to exit early.

This pattern is also useful for polling scenarios, such as refreshing a page until an expected value appears. Set the loop count to a maximum number of retries, then add a condition that exits the loop when the expected element or value is present.

Replay loops in the Trainer

When replaying loops in the mabl Trainer, mabl tries to resume playing the loop at the current index, even if you stopped the loop partway through. Click on the loop dropdown to set the loop to a specific iteration for Trainer playback.

Review loop output in test runs

When you run a test with a loop in the cloud, the test output shows the following tag for each iteration: Loop: {current index}/{total loop count}.

The {total loop count} indicates how many times the loop ran during the test run. This number is not necessarily the same as the configured loop count for the test. For example, if you configured a loop to run 5 times, but the test failed during the third iteration of the loop, the total loop count for the test run will be 3, not 5: Loop: {current index}/3.