Comenzar a usar ChromeDriver

En esta página, se documenta cómo comenzar a usar ChromeDriver para probar tu sitio web en computadoras de escritorio (Windows/Mac/Linux). También puedes leer Cómo comenzar a usar Android o Cómo comenzar a usar ChromeOS.

Configuración

ChromeDriver es un archivo ejecutable independiente que Selenium WebDriver utiliza para controlar Chrome. Lo mantiene el equipo de Chromium con la ayuda de los colaboradores de WebDriver. Si no conoces Selenium WebDriver, puedes consultar el sitio de Selenium.

Si deseas configurar las pruebas para que se ejecuten con ChromeDriver, sigue estos pasos:

• Asegúrate de que Chromium o Google Chrome estén instalados en una ubicación reconocida
  • ChromeDriver espera que Chrome esté instalado en la ubicación predeterminada de tu plataforma. También puedes forzar ChromeDriver para que use una ubicación personalizada estableciendo una función especial.
• Descarga el objeto binario de ChromeDriver para tu plataforma en la sección Descargas de este sitio.
• Ayuda a WebDriver a encontrar el archivo ejecutable de ChromeDriver descargado

Cualquiera de estos pasos debería funcionar:

1. incluir la ubicación de ChromeDriver en tu variable de entorno PATH
2. (Solo Java) especifica la ubicación con la propiedad del sistema webdriver.chrome.driver (consulta el ejemplo a continuación).
3. (Solo Python) incluye la ruta de acceso a ChromeDriver cuando se crea una instancia de webdriver.Chrome (consulta el ejemplo a continuación).

Prueba de muestra

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()

Controla la vida útil de ChromeDriver

La clase ChromeDriver inicia el proceso del servidor de ChromeDriver cuando se crea y lo finaliza cuando se llama a salir. Esto puede perder una cantidad significativa de tiempo en grandes paquetes de pruebas en los que se crea una instancia de ChromeDriver por prueba. Existen dos opciones para solucionar esto:

1. Usa ChromeDriverService. Esta función está disponible para la mayoría de los idiomas y te permite iniciar o detener el servidor de ChromeDriver por tu cuenta. Consulta aquí un ejemplo de Java (con 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()

2. Inicia el servidor de ChromeDriver por separado antes de ejecutar las pruebas y conéctate a él mediante el WebDriver remoto.

Terminal:

$ ./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();
  }
}