Escolher a versão

A seleção da versão é o processo de correspondência de um binário do Chrome de uma determinada versão com um binário do ChromeDriver compatível.

Para a versão 115 e mais recentes

A partir da versão M115, o processo de lançamento do ChromeDriver está integrado ao Chrome. As versões mais recentes do Chrome + ChromeDriver por canal de lançamento (Stable, Beta, Dev, Canary) estão disponíveis no painel de disponibilidade do Chrome for Testing (CfT). Como resultado, talvez não seja mais necessário selecionar uma versão. Escolha qualquer versão do CfT disponível e faça o download do binário do ChromeDriver com a versão correspondente.

Para fazer o download automatizado da versão, use os convenientes endpoints JSON do CfT.

Se você ainda precisar selecionar a versão (por exemplo, para associar um binário do Chrome que não seja CfT a um binário compatível do ChromeDriver), procure a versão do MAJOR.MINOR.BUILD do binário do Chrome nos endpoints JSON latest-patch-versions-per-build para encontrar a versão correspondente do ChromeDriver. Se ainda não houver entrada para a versão MAJOR.MINOR.BUILD, volte ao endpoint JSON latest-versions-per-milestone. Também é possível usar os endpoints LATEST_RELEASE_ no novo local.

Para a versão 114 e anteriores

Mantemos várias versões do ChromeDriver. A versão a ser selecionada depende da versão do Chrome em que ela é usada. Mais especificamente:

  • O ChromeDriver usa o mesmo esquema de números de versão que o Chrome. Acesse https://www.chromium.org/developers/version-numbers (em inglês) para mais detalhes.
  • Cada versão do ChromeDriver é compatível com o Chrome com números de versão principal, secundário e de versão correspondentes. Por exemplo, ChromeDriver 73.0.3683.20supports all Chrome versions that start with73.0.3683`.
  • Antes que uma nova versão principal do Chrome chegue à versão Beta, uma versão correspondente do ChromeDriver será lançada.
  • Após o lançamento inicial de uma nova versão principal, lançaremos patches conforme necessário. Esses patches podem ou não coincidir com as atualizações do Chrome.

Siga estas etapas para selecionar a versão do ChromeDriver a ser transferida:

  • Primeiro, descubra qual versão do Chrome você está usando. Digamos que você tem o 72.0.3626.81 do Chrome.
  • Pegue o número da versão do Chrome, remova a última parte e anexe o resultado ao URL https://chromedriver.storage.googleapis.com/LATEST_RELEASE_. Por exemplo, na versão 72.0.3626.81 do Chrome, você receberia um URL https://chromedriver.storage.googleapis.com/LATEST_RELEASE_72.0.3626.
  • Use o URL criado na última etapa para recuperar um pequeno arquivo que contém a versão do ChromeDriver a ser usada. Por exemplo, o URL acima vai receber um arquivo contendo 72.0.3626.69. O número real pode mudar no futuro.
  • Use o número da versão recuperado na etapa anterior para criar o URL e fazer o download do ChromeDriver. Com a versão 72.0.3626.69, o URL seria https://chromedriver.storage.googleapis.com/index.html?path=72.0.3626.69/.
  • Após o download inicial, é recomendável que você passe novamente pelo processo acima de vez em quando para ver se há versões para a correção de bugs.

Sempre fornecemos o ChromeDriver para as versões Stable e Beta atuais do Chrome. No entanto, se você usa o Chrome do Canal Dev ou Canary ou cria sua própria versão personalizada do Chrome, é possível que não haja um ChromeDriver disponível oficialmente compatível. Nesse caso, tente o seguinte:

  • Primeiro, construa um URL LATEST_Release usando o número da versão principal do Chrome. Por exemplo, com a versão 73.0.3683.86 do Chrome, use o URL https://chromedriver.storage.googleapis.com/LATEST_RELEASE_73. Tente fazer o download de um arquivo pequeno neste URL. Se ela for bem-sucedida, o arquivo vai conter a versão do ChromeDriver a ser usada.
  • Se a etapa acima falhar, reduza a versão principal do Chrome em um e tente novamente. Por exemplo, com a versão 75.0.3745.4 do Chrome, use o URL https://chromedriver.storage.googleapis.com/LATEST_RELEASE_74 para fazer o download de um arquivo pequeno com a versão do ChromeDriver a ser usada.
  • Você também pode usar o build do ChromeDriver Canary.

Além disso, a versão do ChromeDriver da versão estável atual do Chrome pode ser encontrada em https://chromedriver.storage.googleapis.com/LATEST_RELEASE. No entanto, o uso desse arquivo pode ser menos confiável do que os métodos descritos acima.