Switch window

Move a web test to another tab or window, and run every later step there.

Use it when the flow opens a new tab or a popup: a payment page, a sign-in popup (OAuth), a document preview. The step switches to the open tab whose title or URL matches the text you give it.

Parameters

ParameterRequiredDescription
Tab name or URLYesText matched against the title and URL of open tabs. The first matching tab becomes the active one. Supports variables.
Ignore error on this stepNoThe run continues with the next step if no tab matches. Default: off.

Results and metrics

  • Timing: start, end, and duration (in seconds) recorded in the step result.
  • Status: failed if no open tab matches the name or URL.
  • Screenshot: captured in the newly active tab.

What's next?

Verify element

Confirm the new tab shows what you expect

Navigate to URL

Load a different page in the current tab

Last updated on