interface WebDriverTargetLocator (View source)

Used to locate a given frame or window.

Methods

defaultContent()

Switch to the main document if the page contains iframes. Otherwise, switch to the first frame on the page.

frame(WebDriverElement|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()

Switch to the main document if the page contains iframes. Otherwise, switch to the first frame on the page.

Return Value

WebDriver

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

WebDriver frame(WebDriverElement|string $frame)

Switch to the iframe by its id or name.

Parameters

WebDriverElement|string $frame

The WebDriverElement, the id or the name of the frame.

Return Value

WebDriver

The driver focused on the given frame.

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