Driver Binaries

To run automation based on the WebDriver protocol you need to have browser drivers set up that translate the automation commands and are able execute them in the browser. With WebdriverIO v8.14 and above there is no need to manually download and setup any browser drivers anymore as this is handled by WebdriverIO. You only need to have a browser installed, that's it!

The following describes how you can still set up each driver individually. You can find a list with all drivers in the awesome-selenium README.

conseils

If you are looking to set up mobile and other UI platforms, have a look into our Appium Setup guide.

Chromedriver

To automate Chrome you can download Chromedriver directly on the project website or through the NPM package:

npm

npm install -g chromedriver

Yarn

yarn global add chromedriver

pnpm

pnpm add -g chromedriver

You can then start it via:

chromedriver --port=4444 --verbose

Geckodriver

To automate Firefox download the latest version of geckodriver for your environment and unpack it in your project directory:

NPM

npm

npm install geckodriver

Yarn

yarn add geckodriver

pnpm

pnpm add geckodriver

Curl

Linux:

curl -L https://github.com/mozilla/geckodriver/releases/download/v0.24.0/geckodriver-v0.24.0-linux64.tar.gz | tar xz

MacOS (64 bit):

curl -L https://github.com/mozilla/geckodriver/releases/download/v0.24.0/geckodriver-v0.24.0-macos.tar.gz | tar xz

Brew

brew install geckodriver

Windows (64 bit / Chocolatey)

choco install selenium-gecko-driver

Windows (64 bit / Powershell) DevTools

# Run as privileged session. Right-click and set 'Run as Administrator'
# Use geckodriver-v0.24.0-win32.zip for 32 bit Windows
$url = "https://github.com/mozilla/geckodriver/releases/download/v0.24.0/geckodriver-v0.24.0-win64.zip"
$output = "geckodriver.zip" # will drop into current directory unless defined otherwise
$unzipped_file = "geckodriver" # will unzip to this folder name

# By default, Powershell uses TLS 1.0 the site security requires TLS 1.2
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

# Downloads Geckodriver
Invoke-WebRequest -Uri $url -OutFile $output

# Unzip Geckodriver
Expand-Archive $output -DestinationPath $unzipped_file
cd $unzipped_file

# Globally Set Geckodriver to PATH
[System.Environment]::SetEnvironmentVariable("PATH", "$Env:Path;$pwd\geckodriver.exe", [System.EnvironmentVariableTarget]::Machine)

Note: Other geckodriver releases are available here. After download you can start the driver via:

/path/to/binary/geckodriver --port 4444

Edgedriver

You can download the driver for Microsoft Edge on the project website or as NPM package via:

npm install -g edgedriver
edgedriver --version # prints: Microsoft Edge WebDriver 115.0.1901.203 (a5a2b1779bcfe71f081bc9104cca968d420a89ac)

Safaridriver

Safaridriver comes pre-installed on your MacOS and can be started directly via:

safaridriver -p 4444