switch frame by destination


Switch the focus to the parent frame of the current one or the main frame (default content). (Learn more)

Important: This action is dedicated to Generic WebDriver.
Assuming the current frame is 'frame 2'.
  • If you switch to the parent frame, the new current frame will be 'frame 1'.

  • If you switch to the main frame, the new current frame will be 'main frame'.

When to 'switch frame'

In a web page with multiple frames, you have to switch the focus to the frame containing the element before locating the element.


  • destination: the frame to which you want to shift the focus.

    Allowable values:

    • parent: the parent of the current frame.
    • main: the main frame (default content).

Valid contexts

This action may be used within the following project items: test modules and user-defined actions.

Action lines