org.openqa.selenium

接口 WebDriver.TargetLocator

封闭接口:

WebDriver

public static interface WebDriver.TargetLocator

Used to locate a given frame or window.

方法概要

限定符和类型	方法和说明
WebElement	activeElement() Switches to the element that currently has focus within the document currently "switched to", or the body element if this cannot be detected.
Alert	alert() Switches to the currently active modal dialog for this particular driver instance.
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(String nameOrId) Select a frame by its name or ID.
WebDriver	frame(WebElement frameElement) Select a frame using its previously located WebElement.
WebDriver	parentFrame() Change focus to the parent context.
WebDriver	window(String nameOrHandle) Switch the focus of future commands for this driver to the window with the given name/handle.

方法详细资料

frame

WebDriver frame(int index)

Select a frame by its (zero-based) index. Selecting a frame by index is equivalent to the JS expression window.frames[index] where "window" is the DOM window represented by the current context. Once the frame has been selected, all subsequent calls on the WebDriver interface are made to that frame.

参数:

index - (zero-based) index

返回:

This driver focused on the given frame

抛出:

NoSuchFrameException - If the frame cannot be found

frame

WebDriver frame(String nameOrId)

Select a frame by its name or ID. Frames located by matching name attributes are always given precedence over those matched by ID.

参数:

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

返回:

This driver focused on the given frame

抛出:

NoSuchFrameException - If the frame cannot be found

frame

WebDriver frame(WebElement frameElement)

Select a frame using its previously located WebElement.

参数:

frameElement - The frame element to switch to.

返回:

This driver focused on the given frame.

抛出:

NoSuchFrameException - If the given element is neither an IFRAME nor a FRAME element.

StaleElementReferenceException - If the WebElement has gone stale.

另请参阅:

WebDriver.findElement(By)

parentFrame

WebDriver parentFrame()

Change focus to the parent context. If the current context is the top level browsing context, the context remains unchanged.

返回:

This driver focused on the parent frame

window

WebDriver window(String nameOrHandle)

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

参数:

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

返回:

This driver focused on the given window

抛出:

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.

返回:

This driver focused on the top window/first frame.

activeElement

WebElement activeElement()

Switches to the element that currently has focus within the document currently "switched to", or the body element if this cannot be detected. This matches the semantics of calling "document.activeElement" in Javascript.

返回:

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

alert

Alert alert()

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

返回:

A handle to the dialog.

抛出:

NoAlertPresentException - If the dialog cannot be found