karma-mocha-reporter

Karma reporter plugin with mocha style logging.

How does it look like

Installation

The easiest way is to keep karma-mocha-reporter as a devDependency in your package.json.

1{
2  "devDependencies": {
3    "karma": "^1.0.0",
4    "karma-mocha-reporter": "^2.0.0"
5  }
6}

You can simply do it by:

$ npm install karma-mocha-reporter --save-dev

Configuration

1// karma.conf.js
2module.exports = function(config) {
3  config.set({
4    frameworks: ['jasmine'],
5
6    // reporters configuration
7    reporters: ['mocha']
8  });
9};

Options

colors

Type: Object | Boolean

Lets you overwrite the default colors. Possible values are all colors and background colors from chalk.

Possible Values:

Value	Description	Default
success	success messages	green
info	info messages	grey
warning	warn messages	yellow
error	error messages	red

1// karma.conf.js
2module.exports = function(config) {
3  config.set({

4    frameworks: ['jasmine'],
5
6    // reporters configuration

7    reporters: ['mocha'],
8
9    // reporter options

10    mochaReporter: {

11      colors: {

12        success: 'blue',

13        info: 'bgGreen',

14        warning: 'cyan',

15        error: 'bgRed'
16      },

17      symbols: {

18        success: '+',

19        info: '#',

20        warning: '!',

21        error: 'x'
22      }
23    }
24  });
25};

To disable the colors please use the colors option in the karma config.

1// karma.conf.js
2module.exports = function(config) {
3  config.set({
4    frameworks: ['jasmine'],
5
6    // reporters configuration
7    reporters: ['mocha'],
8
9    // disable colors
10    colors: false
11  });
12};

symbols

Type: Object

Lets you overwrite the default symbols.

Possible Values:

Value	Description	Default
success	success messages	✔
info	info messages	ℹ
warning	warn messages	⚠
error	error messages	✖

1// karma.conf.js
2module.exports = function(config) {
3  config.set({
4    frameworks: ['jasmine'],
5
6    // reporters configuration
7    reporters: ['mocha'],
8
9    // reporter options
10    mochaReporter: {
11      symbols: {
12        success: '+',
13        info: '#',
14        warning: '!',
15        error: 'x'
16      }
17    }
18  });
19};

output

Type: String

Possible Values:

Value	Description
full (default)	all output is printed to the console
autowatch	first run will have the full output and the next runs just output the summary and errors in mocha style
minimal	only the summary and errors are printed to the console in mocha style
noFailures	the failure details are not logged

1// karma.conf.js
2module.exports = function(config) {
3  config.set({
4    frameworks: ['jasmine'],
5
6    // reporters configuration
7    reporters: ['mocha'],
8
9    // reporter options
10    mochaReporter: {
11      output: 'autowatch'
12    }
13  });
14};

showDiff

Type: String | Boolean

Shows a diff output. Is disabled by default. All credits to the contributors of mocha, since the diff logic is used from there and customized for this module.

Currently only works with karma-mocha >= v0.2.2 Not supported for karma-jasmine since the additional properties needed to render the diff are not supported in jasmine yet.

Possible Values:

Value	Description
true	prints each diff in its own line, same as 'unified'
'unified'	prints each diff in its own line
'inline'	prints diffs inline

1// karma.conf.js
2module.exports = function(config) {
3  config.set({
4    frameworks: ['mocha', 'chai'],
5
6    // reporters configuration
7    reporters: ['mocha'],
8
9    // reporter options
10    mochaReporter: {
11      showDiff: true
12    }
13  });
14};

divider

Type: String

Default: 80 equals signs ('=')

The string to output between multiple test runs. Set to false or empty string to disable

1// karma.conf.js
2module.exports = function(config) {
3  config.set({
4    frameworks: ['jasmine'],
5
6    // reporters configuration
7    reporters: ['mocha'],
8
9    // reporter options
10    mochaReporter: {
11      divider: ''
12    }
13  });
14};

ignoreSkipped

Type: Boolean

Possible Values:

• false (default)
• true

When setting the ignoreSkipped flag to true, the reporter will ignore the skipped tests in the output and you will see only the tests that where really executed. The summary will still contain the number of skipped tests.

maxLogLines

Type: Number

Lets you set the maximum number of lines which are printed for a failure. The default value is 999. Helps to cut long stack traces. Set the value to -1 to disable stack traces.

printFirstSuccess

Type: Boolean

Possible Values:

• false (default)
• true

Prints the result of an it block after it is run in one browser. This options is useful when you have tests which are conditionally run in one browser only. Otherwise the result of the it block would not be printed because it was not run in all browsers.

1// testfile.spec.js
2if (navigator.userAgent.match(/firefox/i)) {
3  describe('Firefox tests', function() {
4    it('this would only be reported when printFirstSuccess is true', function() {
5      console.log('firefox test');
6    });
7  });
8}
9
10describe('Other tests', function() {
11  it('this should be always reported', function() {
12    console.log('hello world');
13  });
14});

Contributing

In lieu of a formal styleguide take care to maintain the existing coding style. Lint and test your code using grunt.

You can preview your changes by running:

$ npm run demo

Author

Litixsoft GmbH

License

Copyright (C) 2013-2017 Litixsoft GmbH info@litixsoft.de Licensed under the MIT license.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included i all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.