Bro is a fast browserify integration for Karma that handles large projects with ease.
Get the plug-in via npm
npm install --save-dev karma-bro
Add browserify as a framework to your Karma configuration file. For each file that should be processed and bundled by karma, configure the browserify preprocessor. Optionally use the browserify config entry to configure how the bundle gets created.
module.exports = function(karma) {
karma.set({
frameworks: [ 'browserify', 'any', 'other', 'framework' ],
preprocessors: {
'test/**/*.js': [ 'browserify' ]
},
browserify: {
debug: true,
transform: [ 'brfs' ]
}
});
}Look at the example directory for a simple browserify + jasmine project that uses this plug-in.
The way Bro creates browserified test bundles can be tuned through the browserify configuration property. The following configuration options are supported:
- extensions
- builtins
- basedir
- commondir
- resolve
- transform
- plugin
To generate source maps for easier debugging specify debug: true as an additional configuration option.
In addition you can transform the bundle by calling the prebundle function. This is useful when you need to set up things like externals:
browserify: {
prebundle: function(bundle) {
bundle.external('foobar');
}
}Bro is a preprocessor for Karma that combines test files and dependencies into a browserified bundle. It relies on watchify to generate the bundle and to keep it updated during autoWatch=true.
Before the initial test run Bro builds one browserify bundle for all test cases and dependencies. Once any of the files change, it incrementally updates the bundle. Each file included in karma is required from the file bundle via a stub. Thereby it ensures tests are only executed once per test run.
The following code snippet shows a Karma configuration file with all Bro related options.
module.exports = function(karma) {
karma.set({
// include browserify first in used frameworks
frameworks: [ 'browserify', 'jasmine' ],
// add all your files here,
// including non-commonJS files you need to load before your test cases
files: [
'some-non-cjs-library.js',
'test/**/*.js'
],
// add preprocessor to the files that should be
// processed via browserify
preprocessors: {
'test/**/*.js': [ 'browserify' ]
},
// see what is going on
logLevel: 'LOG_DEBUG',
// use autoWatch=true for quick and easy test re-execution once files change
autoWatch: true,
// add additional browserify configuration properties here
// such as transform and/or debug=true to generate source maps
browserify: {
debug: true,
transform: [ 'brfs' ]
}
});
};Credit goes to to karma-browserify and karma-browserifast. Bro builds on the lessons learned in these projects and offers improved configurability, speed and/or the ability to handle large projects.
MIT