The sui:handle-by-name test object helps you switch the current context of driver between windows or iframes by name.

Release in: 3.0.1

Usage

<sui:handle-by-name method=""! name=""!/>

! - mandatory

Supported methods

Method	Example	Behaviour

Method	Example	Behaviour
frame	`<sui:handle-by-name method="frame" name="iframe-cats"/>`	Switch to the “iframe-cats” Iframe.
window	`<sui:handle-by-name method="window" name="petstoreUi"/>`	Switch to the “petstoreUi” window.
tab	`<sui:handle-by-name method="tab" name="data:"/>`	Switch to the “data:” tab.