README.md

WDIO IEDriver Service

(Based entirely on wdio-selenium-standalone-service.)

---

This service helps you to run IEDriver seamlessly when running tests with the WDIO testrunner. It uses the IEdriver NPM package that wraps the IEDriver for you.

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

capabilities: [{
        browserName: 'internet explorer'
    }]

Installation

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

{
  "devDependencies": {
    "wdio-iedriver-service": "~0.1"
  }
}

You can simple do it by:

npm install wdio-iedriver-service --save-dev

Instructions on how to install WebdriverIO can be found here.

Configuration

By design, only Internet Explorer is available (when installed on the host system). Make sure to read up on InternetExplorerDriver regarding required configuration. Protected Mode-setting can be tweaked by using ignoreProtectedModeSettings: true in capabilities.

In order to use the service you need to add iedriver to your service array:

// wdio.conf.js
export.config = {
  port: '5555',
  path: '/',
  // ...
  services: ['iedriver'],
  // ...
  // options (optional)
  ieDriverLogs: './'
};

Options

ieDriverLogs

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

Type: String

killInstances

Whether to force all instances of Internet Explorer to be closed after the test. Please note that this option will kill all instances, not only those spawned by IEDriverServer!

Type: Boolean

Default: false

---

For more information on WebdriverIO see the homepage.