public class EventFiringWebDriver extends Object implements WebDriver, JavascriptExecutor, TakesScreenshot, WrapsDriver, HasInputDevices, HasTouchScreen
WebDriver instance which supports registering of a
WebDriverEventListener, e.g. for logging purposes.WebDriver.ImeHandler, WebDriver.Navigation, WebDriver.Options, WebDriver.TargetLocator, WebDriver.Timeouts, WebDriver.Window| 构造器和说明 |
|---|
EventFiringWebDriver(WebDriver driver) |
| 限定符和类型 | 方法和说明 |
|---|---|
void |
close()
Close the current window, quitting the browser if it's the last window currently open.
|
Object |
executeAsyncScript(String script,
Object... args)
Execute an asynchronous piece of JavaScript in the context of the currently selected frame or
window.
|
Object |
executeScript(String script,
Object... args)
Executes JavaScript in the context of the currently selected frame or window.
|
WebElement |
findElement(By by)
Find the first
WebElement using the given method. |
List<WebElement> |
findElements(By by)
Find all elements within the current page using the given mechanism.
|
void |
get(String url)
Load a new web page in the current browser window.
|
String |
getCurrentUrl()
Get a string representing the current URL that the browser is looking at.
|
Keyboard |
getKeyboard() |
Mouse |
getMouse() |
String |
getPageSource()
Get the source of the last loaded page.
|
<X> X |
getScreenshotAs(OutputType<X> target)
Capture the screenshot and store it in the specified location.
|
String |
getTitle()
The title of the current page.
|
TouchScreen |
getTouch() |
String |
getWindowHandle()
Return an opaque handle to this window that uniquely identifies it within this driver instance.
|
Set<String> |
getWindowHandles()
Return a set of window handles which can be used to iterate over all open windows of this
WebDriver instance by passing them to
WebDriver.switchTo(). |
WebDriver |
getWrappedDriver() |
WebDriver.Options |
manage()
Gets the Option interface
|
WebDriver.Navigation |
navigate()
An abstraction allowing the driver to access the browser's history and to navigate to a given
URL.
|
void |
quit()
Quits this driver, closing every associated window.
|
EventFiringWebDriver |
register(WebDriverEventListener eventListener) |
WebDriver.TargetLocator |
switchTo()
Send future commands to a different frame or window.
|
EventFiringWebDriver |
unregister(WebDriverEventListener eventListener) |
public EventFiringWebDriver(WebDriver driver)
public EventFiringWebDriver register(WebDriverEventListener eventListener)
eventListener - the event listener to registerpublic EventFiringWebDriver unregister(WebDriverEventListener eventListener)
eventListener - the event listener to unregisterpublic WebDriver getWrappedDriver()
getWrappedDriver 在接口中 WrapsDriverpublic void get(String url)
WebDriverWebDriver.Navigation.to(String).public String getCurrentUrl()
WebDrivergetCurrentUrl 在接口中 WebDriverpublic List<WebElement> findElements(By by)
WebDriverfindElements 在接口中 SearchContextfindElements 在接口中 WebDriverby - The locating mechanism to useWebElements, or an empty list if nothing matchesBy,
WebDriver.Timeoutspublic WebElement findElement(By by)
WebDriverWebElement using the given method.
This method is affected by the 'implicit wait' times in force at the time of execution.
The findElement(..) invocation will return a matching row, or try again repeatedly until
the configured timeout is reached.
findElement should not be used to look for non-present elements, use WebDriver.findElements(By)
and assert zero length response instead.findElement 在接口中 SearchContextfindElement 在接口中 WebDriverby - The locating mechanismBy,
WebDriver.Timeoutspublic String getPageSource()
WebDrivergetPageSource 在接口中 WebDriverpublic void close()
WebDriverpublic void quit()
WebDriverpublic Set<String> getWindowHandles()
WebDriverWebDriver.switchTo().WebDriver.Options.window()getWindowHandles 在接口中 WebDriverpublic String getWindowHandle()
WebDrivergetWindowHandle 在接口中 WebDriverpublic Object executeScript(String script, Object... args)
JavascriptExecutor
Within the script, use document to refer to the current document. Note that local
variables will not be available once the script has finished executing, though global variables
will persist.
If the script has a return value (i.e. if the script contains a return statement),
then the following steps will be taken:
Arguments must be a number, a boolean, a String, WebElement, or a List of any combination of the above. An exception will be thrown if the arguments do not meet these criteria. The arguments will be made available to the JavaScript via the "arguments" magic variable, as if the function were called via "Function.apply"
executeScript 在接口中 JavascriptExecutorscript - The JavaScript to executeargs - The arguments to the script. May be emptypublic Object executeAsyncScript(String script, Object... args)
JavascriptExecutorsynchronous JavaScript,
scripts executed with this method must explicitly signal they are finished by invoking the
provided callback. This callback is always injected into the executed function as the last
argument.
The first argument passed to the callback function will be used as the script's result. This value will be handled as follows:
The default timeout for a script to be executed is 0ms. In most cases, including the examples
below, one must set the script timeout
WebDriver.Timeouts.setScriptTimeout(long, java.util.concurrent.TimeUnit) beforehand
to a value sufficiently large enough.
Example #1: Performing a sleep in the browser under test.
long start = System.currentTimeMillis();
((JavascriptExecutor) driver).executeAsyncScript(
"window.setTimeout(arguments[arguments.length - 1], 500);");
System.out.println(
"Elapsed time: " + System.currentTimeMillis() - start);
Example #2: Synchronizing a test with an AJAX application:
WebElement composeButton = driver.findElement(By.id("compose-button"));
composeButton.click();
((JavascriptExecutor) driver).executeAsyncScript(
"var callback = arguments[arguments.length - 1];" +
"mailClient.getComposeWindowWidget().onload(callback);");
driver.switchTo().frame("composeWidget");
driver.findElement(By.id("to")).sendKeys("bog@example.com");
Example #3: Injecting a XMLHttpRequest and waiting for the result:
Object response = ((JavascriptExecutor) driver).executeAsyncScript(
"var callback = arguments[arguments.length - 1];" +
"var xhr = new XMLHttpRequest();" +
"xhr.open('GET', '/resource/data.json', true);" +
"xhr.onreadystatechange = function() {" +
" if (xhr.readyState == 4) {" +
" callback(xhr.responseText);" +
" }" +
"};" +
"xhr.send();");
JsonObject json = new JsonParser().parse((String) response);
assertEquals("cheese", json.get("food").getAsString());
Script arguments must be a number, a boolean, a String, WebElement, or a List of any combination of the above. An exception will be thrown if the arguments do not meet these criteria. The arguments will be made available to the JavaScript via the "arguments" variable.
executeAsyncScript 在接口中 JavascriptExecutorscript - The JavaScript to execute.args - The arguments to the script. May be empty.WebDriver.Timeouts.setScriptTimeout(long, java.util.concurrent.TimeUnit)public <X> X getScreenshotAs(OutputType<X> target) throws WebDriverException
TakesScreenshotFor WebDriver extending TakesScreenshot, this makes a best effort depending on the browser to return the following in order of preference:
For WebElement extending TakesScreenshot, this makes a best effort depending on the browser to return the following in order of preference: - The entire content of the HTML element - The visible portion of the HTML element
getScreenshotAs 在接口中 TakesScreenshotX - Return type for getScreenshotAs.target - target type, @see OutputTypeWebDriverException - on failure.public WebDriver.TargetLocator switchTo()
WebDriverswitchTo 在接口中 WebDriverWebDriver.TargetLocatorpublic WebDriver.Navigation navigate()
WebDrivernavigate 在接口中 WebDriverWebDriver.Navigation that allows the selection of what to
do nextpublic WebDriver.Options manage()
WebDrivermanage 在接口中 WebDriverWebDriver.Optionspublic Keyboard getKeyboard()
getKeyboard 在接口中 HasInputDevicespublic Mouse getMouse()
getMouse 在接口中 HasInputDevicespublic TouchScreen getTouch()
getTouch 在接口中 HasTouchScreen