WDIO EdgeDriver Service

(Based entirely on wdio-chromedriver-service.)

Note - this service is targeted at WDIO v5.

---

This service helps you to run Microsoft WebDriver (Edge) seamlessly when running tests with the WDIO testrunner. It uses the Microsoft WebDriver service that is installed as a Windows Feature on Demand.

Note - this service does not require a Selenium server, but uses Microsoft WebDriver to communicate with the browser directly. Obviously, it only supports:

capabilities: [{
        browserName: 'MicrosoftEdge'
    }]

Installation

The easiest way is to keep wdio-edgedriver-service as a devDependency in your package.json.

{
  "devDependencies": {
    "wdio-edgedriver-service": "^1.0.0"
  }
}

You can simple do it by:

npm install wdio-edgedriver-service --save-dev

For Chromium-based Edge you also need to install msedgedriver (you can point the proper version):

npm i -D msedgedriver --edgechromiumdriver_version=81.0.416.58

Instructions on how to install WebdriverIO can be found here.

Configuration

By design, only Edge is available. In order to use the service you need to add edgedriver to your service array:

// wdio.conf.js
export.config = {
  // port to find edgedriver
  port: 17556, // default for EdgeDriver
  path: '/',
  // ...
  services: ['edgedriver'],

  // options
  edgeDriverArgs: ['--port=17556'], // default for EdgeDriver
  edgeDriverLogs: './',
  // ...
};

Options

edgeDriverArgs

Array of arguments to pass to the EdgeDriver executable.

• --port will use wdioConfig.port if not specified
• etc.

Type: string[]

edgeDriverLogs

Path where all logs from the EdgeDriver server should be stored.

Type: string

---

For more information on WebdriverIO see the homepage.