Switch Tab

Makes the tab with a matching title, address or position the one later activities use.

Behaviour

Risk: Low · Idempotent: Yes · Safe to retry: Yes · Recovery: Not replayed after a crash

Package UI Automation activities VeloPhex.UIAutomation.Activities 0.7.1-rc.12 · Supported (Core profile) · type id velophex.ui.switchTab

Windows · Needs an interactive desktop session

Properties#

Input#

Title#

Title · String · Optional · Default: Not specified in package metadata

Wildcard pattern (*, ?) or substring of the tab's title. Empty ignores the title.

URL pattern#

UrlPattern · String · Optional · Default: Not specified in package metadata

Wildcard pattern (*, ?) the tab's address must satisfy. Empty ignores the address.

Tab number#

TabNumber · Int32 · Optional · Default: Not specified in package metadata

Which of the matching tabs, counting from 1 in window then tab order. Empty or 0 takes the last one, which is usually the newest.

Session#

Session · String · Optional · Default: Not specified in package metadata

The session id from a Use Application/Browser scope. Empty uses the enclosing scope's session, or outside a scope the most recent matching session.

Timeout (seconds)#

TimeoutSeconds · Int32 · Optional · Default: Not specified in package metadata

How long to keep looking for the element or window. Empty or not positive means the same as the enclosing Use Application/Browser scope, or outside a scope the project default (30 seconds).

Highlight before action#

HighlightBeforeAction · Boolean · Optional · Default: Not specified in package metadata

Draw the highlight around the element before acting on it.

Output#

Tab title#

TabTitle · String · Output

The title of the tab switched to.

Tab URL#

TabUrl · String · Output

The address of the tab switched to.

Rules#

• Must be inside Use Application/Browser.

Retry and risk#

This activity is safe to retry: running it again after a transient failure does not repeat a side effect. If a run is interrupted and the outcome of a step is unknown, the step is never retried automatically (what to do). How activities declare this: characteristics, retries and risk.

Every activity also has the engine's common properties: Timeout and Continue On Error.

Related activities#

• Close App
• Close Tab
• Get URL
• Go Back
• Go Forward
• Navigate To
• Refresh
• Use Application/Browser

Generated from VeloPhex.UIAutomation.Activities 0.7.1-rc.12. Category: UI Automation › Application & Browser. Keywords: ui, automation, element.

Properties

Input

Output

Rules

Retry and risk

Related activities