WDIO Mocha Framework Adapter
A WebdriverIO plugin. Adapter for Mocha testing framework.
Installation
The easiest way is to keep wdio-mocha-framework
as a devDependency in your package.json
.
You can simple do it by:
npm install wdio-mocha-framework --save-dev
Instructions on how to install WebdriverIO
can be found here.
Configuration
Following code shows the default wdio test runner configuration...
// wdio.conf.jsmoduleexports = // ... framework: 'mocha' mochaOpts: ui: 'bdd' // ...;
mochaOpts
Options
Options will be passed to the Mocha instance. See the list of supported Mocha options here.
Note that interfaces supported are bdd
, tdd
and qunit
. If you want to provide a custom interface, it should expose methods compatible with them and be named ending with -bdd
, -tdd
or -qunit
accordingly.
mochaOpts.require (string|string[])
The require
option is useful when you want to add or extend some basic functionality.
For example, let's try to create an anonymous describe
:
wdio.conf.js
suites: login: 'tests/login/*.js' mochaOpts: require: './hooks/mocha.js'
./hooks/mocha.js
; let context file mocha options = moduleparentcontext;let describe = context; context { if callback return ; else callback = name; name = path; return ; }
./tests/TEST-XXX.js
;
Output
TEST-XXX
✓ Login form
mochaOpts.compilers (string[])
Use the given module(s) to compile files. Compilers will be included before requires.
CoffeeScript and similar transpilers may be used by mapping the file extensions and the module name.
mochaOpts: compilers: 'coffee:foo' './bar.js'
Development
All commands can be found in the package.json. The most important are:
Watch changes:
$ npm run watch
Run tests:
$ npm test # run test with coverage report: $ npm run test:cover
Build package:
$ npm build
For more information on WebdriverIO see the homepage.