floss

Floss

Unit-testing for those hard to reach places.

Uses Electron to provide a Mocha unit-testing environment which can be run headlessly or to debugged with DevTools. This was largely inspired by the electron-mocha and mocha-electron projects but didn't quite have the debugging features needed to develop tests.

Gulp Usage

var floss = require('floss');
gulp.task('test', function(done) {
    floss.run('test/index.js', done);    
});

Debug Mode

Open tests in an Electron window where test can can be debuged with debugger and dev tools.

gulp.task('test', function(done) {
    floss.run({
        path: 'test/index.js',
        debug: true
    }, done);
});

Additional Options

Additional properties can be passed to the test code by adding more values to the run options.

gulp.task('test', function(done) {
    floss.run({
        path: 'test/index.js',
        customUrl: 'http://localhost:8080' // <- custom
    }, done);
});

The test code and use the global options property to have access to the run options.

console.log(options.customUrl); // logs: http://localhost:8080

Command Line Usage

Installed globally via npm install -g floss.

floss --path test/index.js

Or installed locally:

node node_modules/.bin/floss --path test/index.js

Debug Mode

To enable debugging use the --debug argument:

floss --path test/index.js --debug