karma-mocha
    Overview
    Documentation
    Tutorials
    Chat
    Insights
    Code
    Dependencies
    Contributors
    Jobs

karma-mocha

A Karma plugin. Adapter for Mocha testing framework.

1.3.0  •  Updated 2 years ago  •  by karma-runner  •  MIT License

js-standard-style npm version npm downloads

Build Status Dependency Status devDependency Status

Adapter for the Mocha testing framework.

Installation

Install karma-mocha and mocha into to your project via npm:

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

karma-mocha should work with any version of mocha.

Since karma-mocha is an adapter for Karma, you likely have it installed already, but in case you don’t:

$ npm install karma --save-dev

If you’re having trouble, Karma provides detailed instructions on installation.

Configuration

Following code shows the default configuration…

// karma.conf.js
module.exports = function(config) {
  config.set({
    frameworks: ['mocha'],

    files: [
      '*.js'
    ]
  });
};

If you want to pass configuration options directly to mocha you can do this in the following way

// karma.conf.js
module.exports = function(config) {
  config.set({
    frameworks: ['mocha'],

    files: [
      '*.js'
    ],

    client: {
      mocha: {
        // change Karma's debug.html to the mocha web reporter
        reporter: 'html',

        // require specific files after Mocha is initialized
        require: [require.resolve('bdd-lazy-var/bdd_lazy_var_global')],

        // custom ui, defined in required file above
        ui: 'bdd-lazy-var/global',
      }
    }
  });
};

If you want run only some tests matching a given pattern you can do this in the following way

karma start &
karma run -- --grep=<pattern>

or

module.exports = function(config) {
  config.set({
    ...
    client: {
      mocha: {
        grep: '<pattern>', // passed directly to mocha
        ...
      }
      ...
    }
  });
};

If you want to expose test properties specific to mocha, you can use the expose option:

module.exports = function(config) {
  config.set({
    ...
    client: {
      mocha: {
        expose: ['body'] // This will be exposed in a reporter as `result.mocha.body`
        ...
      }
      ...
    }
  });
};

If you already have a configuration for Mocha in an opts file, you can use the opts option:

module.exports = function(config) {
  config.set({
    ...
    client: {
      mocha: {
        opts: 'test/mocha.opts' // You can set opts to equal true then plugin will load opts from default location 'test/mocha.opts'
        ...
      }
      ...
    }
  });
};

Internals

On the end of each test karma-mocha passes to karma result object with fields:

  • description Test title.
  • suite List of titles of test suites.
  • success True if test is succeed, false otherwise.
  • skipped True if test is skipped.
  • time Test duration.
  • log List of errors.
  • startTime Milliseconds since epoch that the test started
  • endTime Milliseconds since epoch that the test ended
  • assertionErrors List of additional error info:
    • name Error name.
    • message Error message.
    • actual Actual data in assertion, serialized to string.
    • expected Expected data in assertion, serialized to string.
    • showDiff True if it is configured by assertion to show diff.
  • mocha An optional object listed if you use the expose option

This object will be passed to test reporter.

NB. the start and end times are added by the adapter whereas the duration is calculated by Mocha - as such they probably will not match arithmetically. Ie. endTime - startTime !== duration. These fields have been added so that timestamped reports can be matched up with other timestamped reports from the target device (eg. memory profiling data collected outside the browser)


For more information on Karma see the homepage.

Popularity

Maintenance

Development

Last ver 3 years ago
Created 7 years ago
Last commit 9 months ago
14 days between commits

Technology

Node version: 7.0.0
0 unpacked

Compliance

MIT License
OSI Approved
0 vulnerabilities

Contributors

35 contributors
Friedel Ziegelmayer
Maintainer, 41 commits, 18 merges, 4 PRs
Maksim Ryzhikov
39 commits, 20 merges, 12 PRs
Works at JetBrains, Yandex
Vojta Jina
40 commits, 5 merges
JONATHAN PARK
8 commits
Mark Ethan Trostler
4 commits
Works at ZZO Associates
Martin Hansen
3 commits, 1 PRs
Works at Knowit Amende AS

Tags

karma-plugin
karma-adapter
mocha
Openbase helps developers choose among and use millions of open-source packages, so they can build amazing products faster.
FacebookTwitterLinkedIn
© 2020 Devstore, Inc.