public class ChromeDriver extends RemoteWebDriver implements LocationContext, WebStorage, HasTouchScreen
WebDriver implementation that controls a Chrome browser running on the local machine.
This class is provided as a convenience for easily testing the Chrome browser. The control server
which each instance communicates with will live and die with the instance.
To avoid unnecessarily restarting the ChromeDriver server with each instance, use a
RemoteWebDriver coupled with the desired ChromeDriverService, which is managed
separately. For example:
import static org.junit.Assert.assertEquals;
import org.junit.*;
import org.junit.runner.RunWith;
import org.junit.runners.JUnit4;
import org.openqa.selenium.chrome.ChromeDriverService;
import org.openqa.selenium.remote.DesiredCapabilities;
import org.openqa.selenium.remote.RemoteWebDriver;
{@literal @RunWith(JUnit4.class)}
public class ChromeTest extends TestCase {
private static ChromeDriverService service;
private WebDriver driver;
{@literal @BeforeClass}
public static void createAndStartService() {
service = new ChromeDriverService.Builder()
.usingDriverExecutable(new File("path/to/my/chromedriver.exe"))
.usingAnyFreePort()
.build();
service.start();
}
{@literal @AfterClass}
public static void createAndStopService() {
service.stop();
}
{@literal @Before}
public void createDriver() {
driver = new RemoteWebDriver(service.getUrl(),
DesiredCapabilities.chrome());
}
{@literal @After}
public void quitDriver() {
driver.quit();
}
{@literal @Test}
public void testGoogleSearch() {
driver.get("http://www.google.com");
WebElement searchBox = driver.findElement(By.name("q"));
searchBox.sendKeys("webdriver");
searchBox.quit();
assertEquals("webdriver - Google Search", driver.getTitle());
}
}
Note that unlike ChromeDriver, RemoteWebDriver doesn't directly implement
role interfaces such as LocationContext and WebStorage.
Therefore, to access that functionality, it needs to be
augmented and then cast
to the appropriate interface.RemoteWebDriver.WhenWebDriver.ImeHandler, WebDriver.Navigation, WebDriver.Options, WebDriver.TargetLocator, WebDriver.Timeouts, WebDriver.Window| 构造器和说明 |
|---|
ChromeDriver()
Creates a new ChromeDriver using the
default
server configuration. |
ChromeDriver(Capabilities capabilities)
Creates a new ChromeDriver instance.
|
ChromeDriver(ChromeDriverService service)
Creates a new ChromeDriver instance.
|
ChromeDriver(ChromeDriverService service,
Capabilities capabilities)
Creates a new ChromeDriver instance.
|
ChromeDriver(ChromeDriverService service,
ChromeOptions options)
Creates a new ChromeDriver instance with the specified options.
|
ChromeDriver(ChromeOptions options)
Creates a new ChromeDriver instance with the specified options.
|
| 限定符和类型 | 方法和说明 |
|---|---|
LocalStorage |
getLocalStorage() |
SessionStorage |
getSessionStorage() |
TouchScreen |
getTouch() |
void |
launchApp(String id)
Launches Chrome app specified by id.
|
Location |
location()
Gets the physical location of the browser.
|
void |
setFileDetector(FileDetector detector)
Set the file detector to be used when sending keyboard input.
|
void |
setLocation(Location location)
Sets the physical location.
|
close, executeAsyncScript, executeScript, findElement, findElementByClassName, findElementByCssSelector, findElementById, findElementByLinkText, findElementByName, findElementByPartialLinkText, findElementByTagName, findElementByXPath, findElements, findElementsByClassName, findElementsByCssSelector, findElementsById, findElementsByLinkText, findElementsByName, findElementsByPartialLinkText, findElementsByTagName, findElementsByXPath, get, getCapabilities, getCommandExecutor, getCurrentUrl, getErrorHandler, getFileDetector, getKeyboard, getMouse, getPageSource, getScreenshotAs, getSessionId, getTitle, getWindowHandle, getWindowHandles, manage, navigate, quit, setErrorHandler, setLogLevel, switchTo, toStringpublic ChromeDriver()
default
server configuration.public ChromeDriver(ChromeDriverService service)
service will be started along with the driver,
and shutdown upon calling RemoteWebDriver.quit().service - The service to use.ChromeDriver(ChromeDriverService, ChromeOptions)public ChromeDriver(Capabilities capabilities)
capabilities will be passed to the
chromedriver service.capabilities - The capabilities required from the ChromeDriver.ChromeDriver(ChromeDriverService, Capabilities)public ChromeDriver(ChromeOptions options)
options - The options to use.ChromeDriver(ChromeDriverService, ChromeOptions)public ChromeDriver(ChromeDriverService service, ChromeOptions options)
service will be
started along with the driver, and shutdown upon calling RemoteWebDriver.quit().service - The service to use.options - The options to use.public ChromeDriver(ChromeDriverService service, Capabilities capabilities)
service will be started along with the
driver, and shutdown upon calling RemoteWebDriver.quit().service - The service to use.capabilities - The capabilities required from the ChromeDriver.public void setFileDetector(FileDetector detector)
RemoteWebDriversetFileDetector 在类中 RemoteWebDriverdetector - The detector to use. Must not be null.FileDetector,
LocalFileDetector,
UselessFileDetectorpublic LocalStorage getLocalStorage()
getLocalStorage 在接口中 WebStoragepublic SessionStorage getSessionStorage()
getSessionStorage 在接口中 WebStoragepublic Location location()
LocationContextlocation 在接口中 LocationContextLocation containing the location information. Returns null if the location is
not availablepublic void setLocation(Location location)
LocationContextsetLocation 在接口中 LocationContextlocation - A Location containing the new location informationpublic TouchScreen getTouch()
getTouch 在接口中 HasTouchScreenpublic void launchApp(String id)
id - chrome app id