Skip to main content

Karma Runner

Installation​

A plugin to use the karma test runner (or @angular/cli's ng test) in Stryker.

Install​

Install @stryker-mutator/karma-runner locally within your project folder, like so:

npm i --save-dev @stryker-mutator/karma-runner

Bring your own test runner​

The @stryker-mutator/karma-runner is a plugin for stryker to enable karma as a test runner. However, it does not come packaged with it's own version of karma, instead it uses your very own karma version. It can also work with @angular/cli, see Configuring

Note: karma v2.0.3 has a known issue which makes it impossible to use it with Stryker. please upgrade to 2.0.4 or higher.

Configuring​

You can configure the @stryker-mutator/karma-runner using the stryker.conf.js (or stryker.conf.json) config file.

{
  "testRunner": "karma",
  "karma": {
    "projectType": "custom",
    "configFile": "path/to/karma.conf.js",
    "config": {
      "browsers": ["ChromeHeadless"]
    }
  }
}

karma.projectType ["custom" | "angular-cli"]​

Default: "custom"

Specify which kind of project you're using. This determines which command is used to start karma

  • "custom": configure @stryker-mutator/karma-runner to use karma start.
  • "angular-cli": configure @stryker-mutator/karma-runner to use ng test (see configuring for angular-cli).

karma.configFile [string]​

Default: undefined

Specify a 'karma.conf.js' file to be loaded. Options specified directly in your stryker.conf.js file using karma.config will overrule options in your karma.conf.js file.

karma.config [object]​

Default: undefined

Specify karma configuration options directly. Options specified here will overrule any options in your karma.conf.js file.

karma.ngConfig.testArguments [object]​

Default: undefined

Add ng test arguments. For example, specify an alternative project with:

{
  "karma": {
    "projectType": "angular-cli",
      "ngConfig": {
        "testArguments": {
          "project": "my-lib"
        }
    }
  }
}

This will run ng test with --project argument: ng test --project=my-lib.

Non overridable options​

The browser's life cycle is determined by @stryker-mutator/karma-runner. I.e. these settings cannot be overridden. You configuration settings for these will be ignored.

{
  browserNoActivityTimeout: 1000000,
  autoWatch: false,
  singleRun: false,
  detached: false
}

The coverage plugin will also be removed (not needed for mutation testing).

Configure angular cli​

Please follow the angular guide.

Debugging​

As Stryker runs karma in its own process, its logging output will be consumed by Stryker.

To see all logging from karma, set the log level to trace in stryker.conf.json.

{
  "logLevel": "trace"
}