interface WebDriverTargetLocator (View source)

Used to locate a given frame or window.

Constants

WINDOW_TYPE_WINDOW

WINDOW_TYPE_TAB

Methods

defaultContent()

Set the current browsing context to the current top-level browsing context.

frame(WebDriverElement|null|int|string $frame)

Switch to the iframe by its id or name.

window(string $handle)

Switch the focus to another window by its handle.

alert()

Switch to the currently active modal dialog for this particular driver instance.

activeElement()

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

Details

WebDriver defaultContent()

Set the current browsing context to the current top-level browsing context.

This is the same as calling RemoteTargetLocator::frame(null);

Return Value

WebDriver

The driver focused on the top window or the first frame.

WebDriver frame(WebDriverElement|null|int|string $frame)

Switch to the iframe by its id or name.

Parameters

WebDriverElement|null|int|string $frame

The WebDriverElement, the id or the name of the frame. When null, switch to the current top-level browsing context When int, switch to the WindowProxy identified by the value. When an Element, switch to that Element.

Return Value

WebDriver

The driver focused on the given frame.

Exceptions

InvalidArgumentException

WebDriver window(string $handle)

Switch the focus to another window by its handle.

Parameters

string $handle

The handle of the window to be focused on.

Return Value

WebDriver

The driver focused on the given window.

See also

WebDriver::getWindowHandles

WebDriverAlert alert()

Switch to the currently active modal dialog for this particular driver instance.

Return Value

WebDriverAlert

WebDriverElement activeElement()

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

Return Value

WebDriverElement