Switch browser tab

axiom.switchBrowserTab(selectTab) switches the session's active tab. Use it after axiom.goto(url, false, true) (or any other action that opens a new tab) to drive the newly opened tab. The same step type as the No-Code Tool's Switch browser tab.

Signature

await axiom.switchBrowserTab(selectTab);
ParameterTypeRequiredDescription
selectTabstringYesA substring of the target tab's title or URL. The session switches to the first tab whose title or URL contains this string.

Example

Open a second tab and switch focus to it:

await axiom.goto("https://example.com/dashboard");
await axiom.goto("https://example.com/reports", false, true);   // opens in new tab
await axiom.switchBrowserTab("reports");                          // focus the new tab
await axiom.click(".export-csv");

Notes

  • The match is a substring search against tab title and URL. Use a string that's unique to the target tab — if multiple tabs match, the first match wins.
  • After a switch, subsequent step methods act on the newly active tab. The previous tab stays open until the session closes (or you switch back and close it).
  • All tabs share runtime quota and the same axiom instance. For genuine parallelism, create multiple AxiomApi instances.
Previous
Date picker
Next
Get clipboard contents
On this page