Automation Guide Action-based testing language Built-in actions Test Support actions WebDriver

 switch frame by destination

switch frame by destination

Description

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

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.

Argument

• 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