karma-source-map-support

Karma plugin for inline sourcemap support.

Motivation

When loading Browserify bundles with inline source maps (via karma-browserify), the stack traces in Chrome don't mention the original modules. This plugin uses source-map-support to improve the situation.

Use

Install the plugin with npm:

npm install karma-source-map-support

Configure Karma to load the plugin as a framework:

1module.exports = function(config) {
2  config.set({
3    frameworks: ['source-map-support']
4    // additional settings here ...
5  });
6};

Example

The config settings below are a complete example using Mocha and Browserify with source map support:

1module.exports = function(config) {
2  config.set({
3    frameworks: ['browserify', 'source-map-support', 'mocha'],
4    files: [
5      'src/**/*.test.js'
6    ],
7    preprocessors: {
8      'src/**/*.test.js': ['browserify']
9    },
10    browsers: ['PhantomJS'],
11    singleRun: false,
12    browserify: {
13      debug: true // include inline source maps
14    }
15  });
16};

Sample stack trace without this plugin:

AssertionError: case 2: expected [ 0, 0.6666666666666666 ] to deeply equal [ 0, 0.5 ]
    at Function.assert.deepEqual (http://localhost:9876/absolute/var/folders/6m/3grlt52x7w3047wy0n6j7dr00000gn/T/2d4c510ad9122153a42db199d1cc8e9553208184.browserify:1848:32)
    at Context.<anonymous> (http://localhost:9876/absolute/var/folders/6m/3grlt52x7w3047wy0n6j7dr00000gn/T/2d4c510ad9122153a42db199d1cc8e9553208184.browserify:6061:14)
    at callFn (http://localhost:9876/base/node_modules/mocha/mocha.js:4496:21)
    at Test.Runnable.run (http://localhost:9876/base/node_modules/mocha/mocha.js:4489:7)
    at Runner.runTest (http://localhost:9876/base/node_modules/mocha/mocha.js:4892:10)
    at http://localhost:9876/base/node_modules/mocha/mocha.js:4970:12
    at next (http://localhost:9876/base/node_modules/mocha/mocha.js:4817:14)
    at http://localhost:9876/base/node_modules/mocha/mocha.js:4827:7
    at next (http://localhost:9876/base/node_modules/mocha/mocha.js:4766:23)
    at http://localhost:9876/base/node_modules/mocha/mocha.js:4794:5

Sample stack trace with this plugin:

AssertionError: case 2: expected [ 0, 0.6666666666666666 ] to deeply equal [ 0, 0.5 ]
    at Function.assert.deepEqual (node_modules/chai/lib/chai/interface/assert.js:205:1)
    at Context.<anonymous> (src/scenes/util/geom.test.js:27:1)
    at callFn (http://localhost:9876/base/node_modules/mocha/mocha.js:4496:21)
    at Test.Runnable.run (http://localhost:9876/base/node_modules/mocha/mocha.js:4489:7)
    at Runner.runTest (http://localhost:9876/base/node_modules/mocha/mocha.js:4892:10)
    at http://localhost:9876/base/node_modules/mocha/mocha.js:4970:12
    at next (http://localhost:9876/base/node_modules/mocha/mocha.js:4817:14)
    at http://localhost:9876/base/node_modules/mocha/mocha.js:4827:7
    at next (http://localhost:9876/base/node_modules/mocha/mocha.js:4766:23)
    at http://localhost:9876/base/node_modules/mocha/mocha.js:4794:5