org.openqa.selenium
Interface WebDriver.TargetLocator

Enclosing interface:

WebDriver

public static interface WebDriver.TargetLocator

Used to locate a given frame or window.

Method Summary

WebElement	activeElement() Switches to the element that currently has focus, or the body element if this cannot be detected.
WebDriver	defaultContent() Selects either the first frame on the page, or the main document when a page contains iframes.
WebDriver	frame(int index) Select a frame by its (zero-based) index.
WebDriver	frame(java.lang.String nameOrIdOrIndex) Select a frame by its name, id or (zero-based) index.
WebDriver	window(java.lang.String nameOrHandle) Switch the focus of future commands for this driver to the window with the given name/handle.

Method Detail

frame

WebDriver frame(int index)

Select a frame by its (zero-based) index. That is, if a page has three frames, the first frame would be at index "0", the second at index "1" and the third at index "2". Once the frame has been selected, all subsequent calls on the WebDriver interface are made to that frame.

Parameters:

index - (zero-based) index

Returns:

This driver focused on the given frame

Throws:

NoSuchFrameException - If the frame cannot be found

frame

WebDriver frame(java.lang.String nameOrIdOrIndex)

Select a frame by its name, id or (zero-based) index. To select sub-frames, simply separate the frame names/IDs/indexes by dots. As an example "main.child" will select the frame with the name "main" and then it's child "child". If the given string represents an integer number, then it will be used to select a frame by its (zero-based) index.

Parameters:

nameOrIdOrIndex - the name of the frame window, the id of the <frame> or <iframe> element, or the (zero-based) index

Returns:

This driver focused on the given frame

Throws:

NoSuchFrameException - If the frame cannot be found

window

WebDriver window(java.lang.String nameOrHandle)

Switch the focus of future commands for this driver to the window with the given name/handle.

Parameters:

nameOrHandle - The name of the window or the handle as returned by WebDriver.getWindowHandle()

Returns:

This driver focused on the given window

Throws:

NoSuchWindowException - If the window cannot be found

defaultContent

WebDriver defaultContent()

Selects either the first frame on the page, or the main document when a page contains iframes.

Returns:

This driver focused on the top window/first frame.

activeElement

WebElement activeElement()

Switches to the element that currently has focus, or the body element if this cannot be detected.

Returns:

The WebElement with focus, or the body element if no element with focus can be detected.