grunt-webdriver is a grunt plugin to run selenium tests with the WebdriverIO test runner
This plugin requires Grunt
If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:
npm install --save-dev grunt-webdriver
This grunt plugin only runs with WebdriverIO >=v3.x. Make sure you have the latest WebdriverIO version installed as dependency:
In your project's Gruntfile, add a section named
webdriver to the data
object passed into
grunt.initConfig(). Your test should contain a
property with a path to your wdio config. You can pass in additional options
as cli arguments.
Run this task with the
grunt webdriver command.
gruntinitConfigwebdriver:test:configFile: './test/wdio.conf.js'// ...
The plugin is an easy helper to run WebdriverIO tests using the wdio test runner. You can find more information about the test runner on our docs page.
To use a cloud service like Sauce Labs make sure you define
port properties like in the example below as well as authenticate yourself with your username and key.
gruntinitConfigwebdriver:options:user: SAUCE_USERNAMEkey: SAUCE_ACCESS_KEYtest:configFile: './test/wdio.conf.js'// ...
All options get passed into to the wdio process. You should define your main configurations within your wdio config file. The plugin allows you to easy overwrite them. You can find all available cli arguments here: http://webdriver.io/guide/testrunner/gettingstarted.html
If you like to write your tests in CoffeeScript just add the following on the top of your Gruntfile and you are set.
require'coffee-script/register';// Project configuration.gruntinitConfig// ...;
Please fork, add specs, and send pull requests! In lieu of a formal styleguide, take care to maintain the existing coding style.