Prerequisites
Your test opens more than one browser tab during execution (for example, a link that opens in a new tab).
What Is Switch To Tab?
Switch To Tab lets you change the active browser tab during a test run.
Instead of being limited to the tab that is currently in focus, you can tell Thunders to switch to another open tab by its Tab Number.
Why Switch To Tab?
Switch To Tab is designed to make multi‑tab scenarios reliable and easy to debug:
Handle real user flows like “Open invoice in a new tab”, “Continue checkout in another tab”, or “Open Terms & Conditions”.
Control which tab the test is interacting with.
Keep your run readable by making tab changes explicit in your steps.
How to Use Switch To Tab
1. Run your scenario and confirm multiple tabs are open
During execution, your flow may open additional tabs. When a new tab is opened, Thunders will automatically switch to it.
2. Add a Browser step
In your test steps, add a Browser step.
3. Select the action Switch To Tab
Choose Switch To Tab from the action list.
4. Enter the Tab Number
In the value field, enter the Tab Number of the tab you want to switch to.
The label is Tab Number.
The placeholder is Enter tab number (e.g., 1, 2, 3).
Tab numbers start at 1.Example: use 2 to switch to the second open tab.
5. Continue your steps in the new tab
Once you switch, all following steps run in that tab until another tab change happens or a new tab is opened.
Troubleshooting / FAQ
I entered a tab number and the step fails — why?
The most common cause is: The tab you’re trying to switch to does not exist (for example, you asked for tab 3 but only 2 tabs are open).
Do I need to specify a URL or title to switch tabs?
No. Switch To Tab switches by Tab Number.
What does “Tab Number” refer to?
It is the position of the tab among the currently open tabs in the run (starting at 1).
What if my flow opens tabs unexpectedly?
If your application opens new tabs unexpectedly, your test may still continue, but it can become harder to predict which tab is active. Adding an explicit Switch To Tab step keeps the context clear.
When I have 2 tabs (tab1 and tab2), then I switch to tab 1, and perform an action that opens a new tab, what will be the number of the new tab?
New tabs are always opened at the end. If you perform a click that opens a new tab while on tab 1, the new tab will be tab 3.