本页记录了如何开始使用 ChromeDriver 来测试您的网站: 桌面 (Windows/Mac/Linux)。您还可以阅读 Android 使用入门或 ChromeOS 使用入门。
设置
ChromeDriver 是 Selenium WebDriver 用于控制 Chrome 的独立可执行文件。此扩展程序由 Chromium 团队在 WebDriver 贡献者的帮助下进行维护。如果您不熟悉 Selenium WebDriver,则应访问 Selenium 网站。
请按以下步骤设置测试,以便与 ChromeDriver 一起运行:
- 确保 Chromium/Google Chrome 安装在可识别的位置 <ph type="x-smartling-placeholder">
- </ph>
- ChromeDriver 希望您将 Chrome 安装到适用于您的平台的默认位置。您还可以通过设置特殊功能强制 ChromeDriver 使用自定义位置。
- 在本网站的下载部分,下载适用于您平台的 ChromeDriver 二进制文件
- 帮助 WebDriver 找到已下载的 ChromeDriver 可执行文件
只要执行下列任一步骤,就能解决问题:
- 将 ChromeDriver 位置包含在 PATH 环境变量中
- (仅限 Java)使用 webdriver.chrome.driver 系统属性指定其位置(参见下面的示例)
- (仅限 Python)在实例化 webdriver.Chrome 时包含 ChromeDriver 的路径(参见下面的示例)
示例测试
Java:
import org.openqa.selenium.*; import org.openqa.selenium.chrome.*; import org.junit.Test; public class GettingStarted { @Test public void testGoogleSearch() throws InterruptedException { // Optional. If not specified, WebDriver searches the PATH for chromedriver. // System.setProperty("webdriver.chrome.driver", "/path/to/chromedriver"); // WebDriver driver = new ChromeDriver(); driver.get("http://www.google.com/"); Thread.sleep(5000); // Let the user actually see something! WebElement searchBox = driver.findElement(By.name("q")); searchBox.sendKeys("ChromeDriver"); searchBox.submit(); Thread.sleep(5000); // Let the user actually see something! driver.quit(); } }
Python:
import time from selenium import webdriver driver = webdriver.Chrome('/path/to/chromedriver') # Optional argument, if not specified will search path. driver.get('http://www.google.com/'); time.sleep(5) # Let the user actually see something! search_box = driver.find_element_by_name('q') search_box.send_keys('ChromeDriver') search_box.submit() time.sleep(5) # Let the user actually see something! driver.quit()
控制 ChromeDriver 的生命周期
ChromeDriver 类在创建时启动 ChromeDriver 服务器进程,并在调用 quit 时终止它。对于大型测试套件(每个测试都创建一个 ChromeDriver 实例),这可能会浪费大量时间。您可以通过以下两种方式进行补救:
- 使用 ChromeDriverService。此功能适用于大多数语言,并且可让您自行启动或停止 ChromeDriver 服务器。请参见此处的 Java 示例(使用 JUnit 4):
import java.io.*; import org.junit.*; import org.openqa.selenium.*; import org.openqa.selenium.chrome.*; import org.openqa.selenium.remote.*; public class GettingStartedWithService { private static ChromeDriverService service; private WebDriver driver; @BeforeClass public static void createAndStartService() throws IOException { service = new ChromeDriverService.Builder() .usingDriverExecutable(new File("/path/to/chromedriver")) .usingAnyFreePort() .build(); service.start(); } @AfterClass public static void stopService() { service.stop(); } @Before public void createDriver() { driver = new RemoteWebDriver(service.getUrl(), new ChromeOptions()); } @After public void quitDriver() { driver.quit(); } @Test public void testGoogleSearch() { driver.get("http://www.google.com"); // rest of the test... } }
Python:
import time from selenium import webdriver from selenium.webdriver.chrome.service import Service service = Service('/path/to/chromedriver') service.start() driver = webdriver.Remote(service.service_url) driver.get('http://www.google.com/'); time.sleep(5) # Let the user actually see something! driver.quit()
- 请先单独启动 ChromeDriver 服务器,然后再运行测试,然后使用远程 WebDriver 连接到该服务器。
航站楼:
$ ./chromedriver Starting ChromeDriver 76.0.3809.68 (...) on port 9515 ...
Java:
import java.net.*; import org.openqa.selenium.*; import org.openqa.selenium.chrome.*; import org.openqa.selenium.remote.*; public class GettingStartedRemote { public static void main(String[] args) throws MalformedURLException { WebDriver driver = new RemoteWebDriver( new URL("http://127.0.0.1:9515"), new ChromeOptions()); driver.get("http://www.google.com"); driver.quit(); } }