Enable support for generators in Mocha tests
Last updated 7 months ago by blakeembrey .
MIT · Repository · Bugs · Original npm · Tarball
$ cnpm install co-mocha 
SYNC missed versions from official npm registry.

Co Mocha

NPM version NPM downloads Build status Test coverage Greenkeeper badge

Enable support for generators in Mocha tests using co.

Use the --harmony-generators flag when running node 0.11.x to access generator functions, or transpile your tests using traceur or regenerator.


npm install co-mocha --save-dev


Just require the module in your tests and start writing generators in your tests.

it('should do something', function * () {
  yield users.load(123)


Install the module using npm install co-mocha --save-dev. Now just require the module to automatically monkey patch any available mocha instances. With mocha, you have multiple ways of requiring the module - add --require co-mocha to your mocha.opts or add require('co-mocha') inside your main test file.

If you need to monkey patch a different mocha instance you can use the library directly:

var mocha = require('mocha')
var coMocha = require('co-mocha')


<script> Tag

<script src="co-mocha.js"></script>

Including the browserified script will automatically patch window.Mocha. Just make sure you include it after mocha.js. If that is not possible the library exposes window.coMocha, which can be used (window.coMocha(window.Mocha)).


Same details as the script, but using AMD requires instead.

How It Works

The module monkey patches the method of mocha to enable generators. In contrast to other npm packages, co-mocha extends mocha at runtime - allowing you to use any compatible mocha version.



Copyright 2014 - 2016 © |