WebDriver

所有超级接口:

SearchContext

所有已知实现类:

ChromeDriver, EdgeDriver, EventFiringWebDriver, FirefoxDriver, InternetExplorerDriver, OperaDriver, RemoteWebDriver, SafariDriver
```
public interface WebDriver
extends SearchContext
```
The main interface to use for testing, which represents an idealised web browser. The methods in this class fall into three categories:
- Control of the browser itself
- Selection of WebElements
- Debugging aids
Key methods are get(String), which is used to load a new web page, and the various methods similar to findElement(By), which is used to find WebElements.
Currently, you will need to instantiate implementations of this class directly. It is hoped that you write your tests against this interface so that you may "swap in" a more fully featured browser when there is a requirement for one.
Note that all methods that use XPath to locate elements will throw a RuntimeException should there be an error thrown by the underlying XPath engine.

嵌套类概要

嵌套类
限定符和类型	接口和说明
`static interface`	`WebDriver.ImeHandler` An interface for managing input methods.
`static interface`	`WebDriver.Navigation`
`static interface`	`WebDriver.Options` An interface for managing stuff you would do in a browser menu
`static interface`	`WebDriver.TargetLocator` Used to locate a given frame or window.
`static interface`	`WebDriver.Timeouts` An interface for managing timeout behavior for WebDriver instances.
`static interface`	`WebDriver.Window`

方法概要

所有方法实例方法抽象方法
限定符和类型	方法和说明
`void`	`close()` Close the current window, quitting the browser if it's the last window currently open.
`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.
`String`	`getPageSource()` Get the source of the last loaded page.
`String`	`getTitle()` The title of the current page.
`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 `switchTo()`.
`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.
`WebDriver.TargetLocator`	`switchTo()` Send future commands to a different frame or window.

- 方法详细资料
  - get
```
void get(String url)
```
    Load a new web page in the current browser window. This is done using an HTTP GET operation, and the method will block until the load is complete. This will follow redirects issued either by the server or as a meta-redirect from within the returned HTML. Should a meta-redirect "rest" for any duration of time, it is best to wait until this timeout is over, since should the underlying page change whilst your test is executing the results of future calls against this interface will be against the freshly loaded page. Synonym for WebDriver.Navigation.to(String).
    
    参数:
    
    url - The URL to load. It is best to use a fully qualified URL
  - getCurrentUrl
```
String getCurrentUrl()
```
    Get a string representing the current URL that the browser is looking at.
    
    返回:
    
    The URL of the page currently loaded in the browser
  - getTitle
```
String getTitle()
```
    The title of the current page.
    
    返回:
    
    The title of the current page, with leading and trailing whitespace stripped, or null if one is not already set
  - findElements
```
List<WebElement> findElements(By by)
```
    Find all elements within the current page using the given mechanism. This method is affected by the 'implicit wait' times in force at the time of execution. When implicitly waiting, this method will return as soon as there are more than 0 items in the found collection, or will return an empty list if the timeout is reached.
    
    指定者:
    
    findElements 在接口中 SearchContext
    
    参数:
    
    by - The locating mechanism to use
    
    返回:
    
    A list of all WebElements, or an empty list if nothing matches
    
    另请参阅:
    
    By, WebDriver.Timeouts
  - findElement
```
WebElement findElement(By by)
```
    Find the first WebElement 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 findElements(By) and assert zero length response instead.
    
    指定者:
    
    findElement 在接口中 SearchContext
    
    参数:
    
    by - The locating mechanism
    
    返回:
    
    The first matching element on the current page
    
    抛出:
    
    NoSuchElementException - If no matching elements are found
    
    另请参阅:
    
    By, WebDriver.Timeouts
  - getPageSource
```
String getPageSource()
```
    Get the source of the last loaded page. If the page has been modified after loading (for example, by Javascript) there is no guarantee that the returned text is that of the modified page. Please consult the documentation of the particular driver being used to determine whether the returned text reflects the current state of the page or the text last sent by the web server. The page source returned is a representation of the underlying DOM: do not expect it to be formatted or escaped in the same way as the response sent from the web server. Think of it as an artist's impression.
    
    返回:
    
    The source of the current page
  - close
```
void close()
```
    Close the current window, quitting the browser if it's the last window currently open.
  - quit
```
void quit()
```
    Quits this driver, closing every associated window.
  - getWindowHandles
```
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 switchTo().WebDriver.Options.window()
    
    返回:
    
    A set of window handles which can be used to iterate over all open windows.
  - getWindowHandle
```
String getWindowHandle()
```
    Return an opaque handle to this window that uniquely identifies it within this driver instance. This can be used to switch to this window at a later date
    
    返回:
    
    the current window handle
  - switchTo
```
WebDriver.TargetLocator switchTo()
```
    Send future commands to a different frame or window.
    
    返回:
    
    A TargetLocator which can be used to select a frame or window
    
    另请参阅:
    
    WebDriver.TargetLocator
  - navigate
```
WebDriver.Navigation navigate()
```
    An abstraction allowing the driver to access the browser's history and to navigate to a given URL.
    
    返回:
    
    A WebDriver.Navigation that allows the selection of what to do next
  - manage
```
WebDriver.Options manage()
```
    Gets the Option interface
    
    返回:
    
    An option interface
    
    另请参阅:
    
    WebDriver.Options

接口 WebDriver

嵌套类概要

方法概要

方法详细资料

get

getCurrentUrl

getTitle

findElements

findElement

getPageSource

close

quit

getWindowHandles

getWindowHandle

switchTo

navigate

manage