Karma can be extended through plugins. A plugin is essentially an NPM module. Typically, there are four kinds of plugins: frameworks, reporters, launchers and preprocessors. The best way to understand how this works is to take a look at some of the existing plugins. Following sections list some of the plugins that you might use as a reference.
A preprocessor is a function that accepts three arguments (
next), mutates the content in some way, and passes it on to the next preprocessor.
- arguments passed to preprocessor plugins:
content of the file being processed
file object describing the file being processed
- path: the current file, mutable file path. e. g.
some/file.coffee.js This path is mutable and may not actually exist.
- originalPath: the original, unmutated path
- encodings: A mutable, keyed object where the keys are a valid encoding type ('gzip', 'compress', 'br', etc.) and the values are the encoded content. Encoded content should be stored here and not resolved using
- type: determines how to include a file, when serving
next function to be called when preprocessing is complete, should be called as
next(null, processedContent) or
- example plugins: karma-coffee-preprocessor, karma-ng-html2js-preprocessor
- use naming convention is
- user NPM keywords
Crazier stuff #
Karma is assembled by Dependency Injection and a plugin is just an additional DI module (see node-di for more), that can be loaded by Karma. Therefore, it can ask for pretty much any Karma component and interact with it. There are a couple of plugins that do more interesting stuff like this, check out karma-closure, karma-intellij.
Karma Framework API #
Karma Framework connects existing testing libraries to Karma's API, so that their
results can be displayed in a browser and sent back to the server.
Karma frameworks must implement a
window.__karma__.start method that Karma will
call to start test execution. This function is called with an object that has methods
to send results back to karma:
.result a single test has finished
.complete the client completed execution of all the tests
.error an error happened in the client
.info other data (e.g. number of tests or debugging messages)
Most commonly you'll use the
result method to send individual test success or failure
statuses. The method takes an object of the form: