How to Build a PowerShell Script to Keep ChromeDriver Up to Date

You can run automated UI browser tests using technologies like . The UI testing technology will communicate with a " " which will, in turn, drive around the browser. Selenium webdriver : Consumers without a driver's license use a taxi to go to a specific location. The consumers don't know how to drive themselves, and instead provide the desired location to the driver. The taxi driver knows how to drive the vehicle towards the instructed location. In this analogy, the consumers are your UI testing code instructing the webdriver, the taxi driver is the webdriver, and the web browser is the vehicle. An analogy is the webdriver implementation for . ChromeDriver and Selenium work together very well, but given enough time you will run into the following error: ChromeDriver Google Chrome Unhandled exception. System.InvalidOperationException: session not created: This version of ChromeDriver only supports Chrome version 74 (Driver info: chromedriver=74.0.3729.6 (255758eccf3d244491b8a1317aa76e1ce10d57e9-refs/branch-heads/3729@{#29}),platform=Windows NT 10.0.19042 x86_64) (SessionNotCreated) at OpenQA.Selenium.Remote.RemoteWebDriver.UnpackAndThrowOnError(Response errorResponse) at OpenQA.Selenium.Remote.RemoteWebDriver.Execute(String driverCommandToExecute, Dictionary`2 parameters) at OpenQA.Selenium.Remote.RemoteWebDriver.StartSession(ICapabilities desiredCapabilities) at OpenQA.Selenium.Remote.RemoteWebDriver..ctor(ICommandExecutor commandExecutor, ICapabilities desiredCapabilities) at OpenQA.Selenium.Chrome.ChromeDriver..ctor(ChromeDriverService service, ChromeOptions options, TimeSpan commandTimeout) at OpenQA.Selenium.Chrome.ChromeDriver..ctor(ChromeOptions options) at OpenQA.Selenium.Chrome.ChromeDriver..ctor() at SeleniumConsole.Program.Main(String[] args) in C:\Users\niels\source\repos\SeleniumConsole\Program.cs:line 10 . Google Chrome updates very frequently, often leaving the ChromeDriver out of date When the , you will run into the error above. ChromeDriver is incompatible with the installed version of Google Chrome The fix is pretty simple, go back to the and download the most recent version. But after doing this manually every time, Chrome updates will quickly become unmanageable - especially when you run UI tests on multiple servers, on a periodic basis, or inside a continuous integration and deployment pipeline. ChromeDriver website Even worse, the failure of these tests may be connected to email, SMS, and/or phone alerting systems. How to download the correct version of ChromeDriver Luckily, the ChromeDriver website provides a systematic way of downloading the correct version of the ChromeDriver given a specific version of Google Chrome. Here are provided: the instructions First, find out you are using. Let's say you have . which version of Chrome Chrome 72.0.3626.81 Take the Chrome version number, remove the last part, and append the result to URL " ". For example, with Chrome version , you'd get a URL " ". https://chromedriver.storage.googleapis.com/LATEST_RELEASE_ 72.0.3626.81 https://chromedriver.storage.googleapis.com/LATEST_RELEASE_72.0.3626 Use the URL created in the last step to to use. For example, the above URL will get your a file containing " ". (The actual number may change in the future, of course.) retrieve a small file containing the version of ChromeDriver 72.0.3626.69 Use the version number retrieved from the previous step to construct the URL to download ChromeDriver. With version 72.0.3626.69, the URL would be " ". https://chromedriver.storage.googleapis.com/index.html?path=72.0.3626.69/ After the initial download, it is recommended that you occasionally go through the above process again to see if there are any bug fix releases. In the above steps, one small detail has been omitted. You have to download the correct file which will work on the operating system (OS) you're using. You will have the following three options to download via the URL determined in the steps above: chromedriver_linux64.zip (for Linux) chromedriver_mac64.zip (for macOS) chromedriver_win32.zip (for Windows) It's self-explanatory which file you need to download depending on your OS which is why it was probably omitted from the steps. But you will need to keep this in account to automate this process. Build a PowerShell script to install the correct ChromeDriver Let's build this PowerShell script step by step based on the instructions provided by Google. . If you just want to use the end result, feel free to scroll to skip this section First, you need to determine the version of Chrome installed on your local machine. This is arguably the hardest step because this is different for every OS installs software differently. There are also multiple ways to determine the version, some more robust than others. On Windows, you can query the registry for the location of Chrome and then get the version stored inside the property. VersionInfo ( ( ). ).VersionInfo.FileVersion Get-Item Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths\chrome.exe' '(Default)' To properly handle the scenario where Google Chrome isn't installed, you should surround this line with a block and also specify to ensure errors will trigger the Catch block. TryCatch -ErrorAction Stop { ( ( -ErrorAction Stop). ).VersionInfo.FileVersion; } { ; } Try Get-Item Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths\chrome.exe' '(Default)' Catch Throw "Google Chrome not found in registry" Lastly, you only want to run this on Windows, so you should surround this code with the following If-block: ( -or ) { } # $IsWindows will PowerShell Core but not on PowerShell 5 and below, but $Env:OS does # this way you can safely check whether the current machine is running Windows pre and post PowerShell Core If $IsWindows $Env:OS On Linux, the command google-chrome should be globally available when installed. Use the command to get the version using --product-version argument. To handle the scenario where Chrome isn't installed, you test the availability of the command before running it like this: { google-chrome -ErrorAction Stop | ; google-chrome --product-version; } { ; } Try # this will check whether google-chrome command is available Get-Command Out-Null Catch Throw "'google-chrome' command not found" Ensure these commands only run on Linux, using the following ElseIf-block: ( ) { } ElseIf $IsLinux On macOS, you can test if the application has been install at the expected location. If it is, execute the application with the argument. In this case, the Chrome application will prefix the version with "Google Chrome ". Remove the prefix using the string replace method. --version = ; ( ) { = & --version; = .Replace( , ); ; } { ; } $ChromePath '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome' If Test-Path $ChromePath $Version $ChromePath $Version $Version "Google Chrome " "" $Version Else Throw "Google Chrome not found on your MacOS machine" Ensure these commands only run on Linux, using the following ElseIf-block: ( ) { } ElseIf $IsMacOS PowerShell isn't supported on any other operating systems, but just in case add the following Else-block: { ; } Else Throw "Your operating system is not supported by this script." Put the code together and wrap it in a function like this: Get-ChromeVersion { ( -or ) { { ( ( -ErrorAction Stop). ).VersionInfo.FileVersion; } { ; } } ( ) { { google-chrome -ErrorAction Stop | ; google-chrome --product-version; } { ; } } ( ) { = ; ( ) { = & --version; = .Replace( , ); ; } { ; } } { ; } } Function # $IsWindows will PowerShell Core but not on PowerShell 5 and below, but $Env:OS does # this way you can safely check whether the current machine is running Windows pre and post PowerShell Core If $IsWindows $Env:OS Try Get-Item Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths\chrome.exe' '(Default)' Catch Throw "Google Chrome not found in registry" ElseIf $IsLinux Try # this will check whether google-chrome command is available Get-Command Out-Null Catch Throw "'google-chrome' command not found" ElseIf $IsMacOS $ChromePath '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome' If Test-Path $ChromePath $Version $ChromePath $Version $Version "Google Chrome " "" $Version Else Throw "Google Chrome not found on your MacOS machine" Else Throw "Your operating system is not supported by this script." In PowerShell, when a value isn't captured, it is returned to the consumer of the function. (Except when the value is piped to Out-Null). After the Function declaration, put the following lines of code to invoke the function, capture the chrome version, and print it to the output: = Get-ChromeVersion -ErrorAction Stop; ; # Instructions from https://chromedriver.chromium.org/downloads/version-selection # First, find out which version of Chrome you are using. Let's say you have Chrome 72.0.3626.81. $ChromeVersion Write-Output "Google Chrome version found on machine" $ChromeVersion (The comments are the steps provided by the ChromeDriver website.) Remove the last part of the version, query the latest matching release ChromeDriver version from the ChromeDriver website, and print the ChromeDriver version to the output: = .Substring( , .LastIndexOf( )); = ( ).Content; ; # Take the Chrome version number, remove the last part, $ChromeVersion $ChromeVersion 0 $ChromeVersion "." # and append the result to URL "https://chromedriver.storage.googleapis.com/LATEST_RELEASE_". # For example, with Chrome version 72.0.3626.81, you'd get a URL "https://chromedriver.storage.googleapis.com/LATEST_RELEASE_72.0.3626". $ChromeDriverVersion Invoke-WebRequest "https://chromedriver.storage.googleapis.com/LATEST_RELEASE_ " $ChromeVersion Write-Output "Latest matching version of Chrome Driver is " $ChromeDriverVersion Create a temporary file and store the path in a variable . Change the tmp-extension to the zip-extension. $TempFilePath Lastly, create another variable to store the folder path and simply use the temporary file path without extension. $TempFileUnzipPath You will need to to specify where to unzip the ZIP-file later. $TempFileUnzipPath = [System.IO.Path]::GetTempFileName(); = .Replace( , ); -Path -NewName ; = .Replace( , ); $TempFilePath $TempZipFilePath $TempFilePath ".tmp" ".zip" Rename-Item $TempFilePath $TempZipFilePath $TempFileUnzipPath $TempFilePath ".tmp" "" Depending on the OS, download the correct ZIP-file from the ChromeDriver website, unzip it using Expand-Archive and move the driver to the desired location: ( -or ) { -OutFile ; Expand-Archive -DestinationPath ; -Destination -Force; } ( ) { -OutFile ; Expand-Archive -DestinationPath ; -Destination -Force; } ( ) { -OutFile ; Expand-Archive -DestinationPath ; -Destination -Force; } { ; } # Use the URL created in the last step to retrieve a small file containing the version of ChromeDriver to use. For example, the above URL will get your a file containing "72.0.3626.69". (The actual number may change in the future, of course.) # Use the version number retrieved from the previous step to construct the URL to download ChromeDriver. With version 72.0.3626.69, the URL would be "https://chromedriver.storage.googleapis.com/index.html?path=72.0.3626.69/". If $IsWindows $Env:OS Invoke-WebRequest "https://chromedriver.storage.googleapis.com/ /chromedriver_win32.zip" $ChromeDriverVersion $TempZipFilePath $TempZipFilePath $TempFileUnzipPath Move-Item " /chromedriver.exe" $TempFileUnzipPath "path/to/save/chromedriver.exe" ElseIf $IsLinux Invoke-WebRequest "https://chromedriver.storage.googleapis.com/ /chromedriver_linux64.zip" $ChromeDriverVersion $TempZipFilePath $TempZipFilePath $TempFileUnzipPath Move-Item " /chromedriver" $TempFileUnzipPath "path/to/save/chromedriver" ElseIf $IsMacOS Invoke-WebRequest "https://chromedriver.storage.googleapis.com/ /chromedriver_mac64.zip" $ChromeDriverVersion $TempZipFilePath $TempZipFilePath $TempFileUnzipPath Move-Item " /chromedriver" $TempFileUnzipPath "path/to/save/chromedriver" Else Throw "Your operating system is not supported by this script." You should update the "path/to/save/chromedriver" hardcoded string to the desired location or ideally a variable. See the end result script to accept the desired path as a parameter. Note: Lastly, clean up by deleting the temporary zip-file and folder: ; -Recurse; # Clean up temp files Remove-Item $TempZipFilePath Remove-Item $TempFileUnzipPath Executing all this code will download the latest ChromeDriver matching the installed instance of Chrome. End result: Enhanced PowerShell script to download ChromeDriver The code so far has solely focused on executing the instructions provided by Google to keep things easy to digest and streamlined. The end result below will run the same commands, but the adjustments make the script more reusable, flexible, and performant. Here's a list of changes: Add parameters: : The path to save the ChromeDriver to ChromeDriverOutputPath : Specify the version of Chrome you need a ChromeDriver for. Use this parameter in case you want to download a ChromeDriver for a different version of Chrome than the one installed. You can also use this parameter to specify the correct version yourself instead of letting the script detect the local Chrome installation. ChromeVersion : Download the latest ChromeDriver regardless of whether the ChromeDriver at is the same version. ForceDownload $ChromeDriverOutputPath A check was added to prevent unnecessarily download the ChromeDriver if the same version of ChromeDriver is already present at the path specified using $ChromeDriverOutputPath. You can ignore this check by specifying the switch. -ForceDownload By default, PowerShell shows a progress bar when downloading files using Invoke-WebRequest. This progress bar can decrease the download performance by a lot. Here's the final result: [CmdletBinding()] ( [Parameter(Mandatory = )] [string] , [Parameter(Mandatory = )] [string] , [Parameter(Mandatory = )] [Switch] ) = ; = ; Get-ChromeVersion { ( -or ) { { ( ( -ErrorAction Stop). ).VersionInfo.FileVersion; } { ; } } ( ) { { google-chrome -ErrorAction Stop | ; google-chrome --product-version; } { ; } } ( ) { = ; ( ) { = & --version; = .Replace( , ); ; } { ; } } { ; } } ([string]::IsNullOrEmpty( )) { = Get-ChromeVersion -ErrorAction Stop; ; } = .Substring( , .LastIndexOf( )); = ( ).Content; ; (( ) -and ( )) { = & --version; = .Split( )[ ]; ( ) { ; ; ; } } = [System.IO.Path]::GetTempFileName(); = .Replace( , ); -Path -NewName ; = .Replace( , ); ( -or ) { -OutFile ; Expand-Archive -DestinationPath ; -Destination -Force; } ( ) { -OutFile ; Expand-Archive -DestinationPath ; -Destination -Force; } ( ) { -OutFile ; Expand-Archive -DestinationPath ; -Destination -Force; } { ; } ; -Recurse; = ; param $True $ChromeDriverOutputPath $false $ChromeVersion $false $ForceDownload # store original preference to revert back later $OriginalProgressPreference $ProgressPreference # setting progress preference to silently continue will massively increase the performance of downloading the ChromeDriver $ProgressPreference 'SilentlyContinue' Function # $IsWindows will PowerShell Core but not on PowerShell 5 and below, but $Env:OS does # this way you can safely check whether the current machine is running Windows pre and post PowerShell Core If $IsWindows $Env:OS Try Get-Item Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths\chrome.exe' '(Default)' Catch Throw "Google Chrome not found in registry" ElseIf $IsLinux Try # this will check whether google-chrome command is available Get-Command Out-Null Catch Throw "'google-chrome' command not found" ElseIf $IsMacOS $ChromePath '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome' If Test-Path $ChromePath $Version $ChromePath $Version $Version "Google Chrome " "" $Version Else Throw "Google Chrome not found on your MacOS machine" Else Throw "Your operating system is not supported by this script." # Instructions from https://chromedriver.chromium.org/downloads/version-selection # First, find out which version of Chrome you are using. Let's say you have Chrome 72.0.3626.81. If $ChromeVersion $ChromeVersion Write-Output "Google Chrome version found on machine" $ChromeVersion # Take the Chrome version number, remove the last part, $ChromeVersion $ChromeVersion 0 $ChromeVersion "." # and append the result to URL "https://chromedriver.storage.googleapis.com/LATEST_RELEASE_". # For example, with Chrome version 72.0.3626.81, you'd get a URL "https://chromedriver.storage.googleapis.com/LATEST_RELEASE_72.0.3626". $ChromeDriverVersion Invoke-WebRequest "https://chromedriver.storage.googleapis.com/LATEST_RELEASE_ " $ChromeVersion Write-Output "Latest matching version of Chrome Driver is " $ChromeDriverVersion If $ForceDownload -eq $False Test-path $ChromeDriverOutputPath #ChromeDriver 88.0.4324.96 (68dba2d8a0b149a1d3afac56fa74648032bcf46b-refs/branch-heads/4324@{#1784}) $ExistingChromeDriverVersion $ChromeDriverOutputPath $ExistingChromeDriverVersion $ExistingChromeDriverVersion " " 1 If $ChromeDriverVersion -eq $ExistingChromeDriverVersion Write-Output "Chromedriver on machine is already latest version. Skipping." Write-Output "Use -ForceDownload to reinstall regardless" Exit $TempFilePath $TempZipFilePath $TempFilePath ".tmp" ".zip" Rename-Item $TempFilePath $TempZipFilePath $TempFileUnzipPath $TempFilePath ".tmp" "" # Use the URL created in the last step to retrieve a small file containing the version of ChromeDriver to use. For example, the above URL will get your a file containing "72.0.3626.69". (The actual number may change in the future, of course.) # Use the version number retrieved from the previous step to construct the URL to download ChromeDriver. With version 72.0.3626.69, the URL would be "https://chromedriver.storage.googleapis.com/index.html?path=72.0.3626.69/". If $IsWindows $Env:OS Invoke-WebRequest "https://chromedriver.storage.googleapis.com/ /chromedriver_win32.zip" $ChromeDriverVersion $TempZipFilePath $TempZipFilePath $TempFileUnzipPath Move-Item " /chromedriver.exe" $TempFileUnzipPath $ChromeDriverOutputPath ElseIf $IsLinux Invoke-WebRequest "https://chromedriver.storage.googleapis.com/ /chromedriver_linux64.zip" $ChromeDriverVersion $TempZipFilePath $TempZipFilePath $TempFileUnzipPath Move-Item " /chromedriver" $TempFileUnzipPath $ChromeDriverOutputPath ElseIf $IsMacOS Invoke-WebRequest "https://chromedriver.storage.googleapis.com/ /chromedriver_mac64.zip" $ChromeDriverVersion $TempZipFilePath $TempZipFilePath $TempFileUnzipPath Move-Item " /chromedriver" $TempFileUnzipPath $ChromeDriverOutputPath Else Throw "Your operating system is not supported by this script." # After the initial download, it is recommended that you occasionally go through the above process again to see if there are any bug fix releases. # Clean up temp files Remove-Item $TempZipFilePath Remove-Item $TempFileUnzipPath # reset back to original Progress Preference $ProgressPreference $OriginalProgressPreference Save this code to a file named 'InstallChromeDriver.ps1' and invoke the script from PowerShell like this: .\InstallChromeDriver.ps1 -ChromeDriverOutputPath .\chromedriver.exe If you want to specify the version of Chrome yourself, add the parameter: -ChromeVersion .\InstallChromeDriver.ps1 -ChromeDriverOutputPath .\chromedriver.exe -ChromeVersion . 88.0 4324.182 If you want to force the download of the driver even if the same version is already downloaded at the specified location, add the parameter: -ForceDownload .\InstallChromeDriver.ps1 -ChromeDriverOutputPath .\chromedriver.exe -ForceDownload I recommend you run this script on a regular basis or right before running your UI tests to keep your ChromeDriver up-to-date. Just make sure that the ChromeDriver isn't being locked by one of your UI tests when you're trying to update it. If you have any issues, feedback, or suggestions, feel free to reach out to me on or comment on . Twitter this GitHub gist Also published on: https://swimburger.net/blog/powershell/download-the-right-chromedriver-on-windows-linux-macos-using-powershell