react-jspm-es6-karma-mocha-istanbul

React with JSPM boilerplate, including testing framework (Karma,Mocha,Istanbul) and examples.

As a bonus, some very helpful testing utilities are also shipped with this bundle: Chai, Chai-As-Promised and Sinon.

Babel is used as the es6 transpiler and has the very nice es7.asyncFunctions enabled, which help a lot to write clean and readable testcases when using System.js API used by JSPM.

To install and run:

$ npm install -g jspm
$ make install

Or step by step

$ npm install -g jspm
$ npm install
$ jspm install
$ jspm install --dev

See it in action

$ open index.html

You may need to start Chrome with a special flag in order to avoid some security restrictions when accessing local files. This post explains the details.

Testing

Now let's do some testing and launch karma

$ npm test

and check test coverage:

$ open coverage/phantomjs/index.html

How to use JSPM's module handling in tests

In order to get both, testcases and sourcefiles, working with es6 module loading, we must distinguish:

1. All dependencies concerning testing can be loaded using plain es6 import syntax, e.g.

	import sinon from 'sinon';

2. The code under test (source files, libraries like React) should be loaded via the System.js API, preferable inside the test cases themselves. This gives a very precise control on dependency handling and empowers us to stub/mock dependencies and restore a fresh system afterwards. Some helpful utilities are part of this bundle to make the job easier. Here's an example:

	import Testsystem from 'test/misc/testsystem';

	describe('foo', () => {
		let react, MyComponent;

		TestSystem.init(); // ensures a fresh and clean System.js environment

		before(async () => {
			[react, {MyComponent}] = await TestSytem.import('react', 'app/components');
		});
	});

Take a look at test/misc/testsystem.js and the all other sample files for more details and examples. In particular the way to stub whole dependencies is quite nice.

Bundeling the project

A simple way to build distribution bundles is also part of this package. It's basically all steps described in this video (minute 24:45).

$ make build