Heads Up! You're viewing the docs for v0.13, an old version of Karma. v6.3 is the newest.

Public Api

Most of the time, you will be using Karma directly from the command line. You can, however, call Karma programmatically from your node module. Here is the public API.

karma.Server(options, [callback=process.exit]) #

Constructor #

var Server = require('karma').Server
var server = new Server({port: 9876}, function(exitCode) {
  console.log('Karma has exited with ' + exitCode)
  process.exit(exitCode)
})

server.start() #

Equivalent of karma start.

server.start()

server.refreshFiles() #

Trigger a file list refresh. Returns a promise.

server.refreshFiles()

Events #

The server object is an EventEmitter. You can simply listen to events like this:

server.on('browser_register', function (browser) {
  console.log('A new browser was registered')
})

browser_register #

Arguments:

  • browser: The browser instance

A new browser was opened, but is not ready yet.

browser_error #

Arguments:

  • browser: The browser instance
  • error: The error that occurred

There was an error on this browser instance.

browser_start #

Arguments:

  • browser: The browser instance
  • info: Details about the run

A test run is beginning in this browser.

browser_complete #

Arguments:

  • browser: The browser instance
  • result: Test results

A test run has completed in this browser.

browsers_change #

Arguments:

  • browsers: A collection of browser instances

The list of browsers has changed.

browsers_ready #

All browsers are ready for execution

run_start #

Arguments:

  • browsers: A collection of browser instances on which tests are executed

A test run starts.

run_complete #

Arguments:

  • browsers: A collection of browser instances
  • results: A list of results

A test run was completed.

karma.runner #

runner.run(options, [callback=process.exit]) #

Equivalent of karma run.

var runner = require('karma').runner
runner.run({port: 9876}, function(exitCode) {
  console.log('Karma has exited with ' + exitCode)
  process.exit(exitCode)
})

Callback function notes #

  • If there is an error, the error code will be provided as the second parameter to the error callback.