mk

min-karma

Minimal Karma Runner Setup and Package in one --- Start testing now!

Showing:

Popularity

Downloads/wk

1

GitHub Stars

7

Maintenance

Last Commit

7mos ago

Contributors

9

Package

Dependencies

6

License

MIT

Type Definitions

Tree-Shakeable

No?

Categories

Readme

min-karma

Minimal Karma runner Setup and Package — Start testing now!

npm version Build Status Code Climate Dependency Status Commitizen friendly

PRs Welcome MIT License npm downloads

js-standard-style

Other minimal setup

Karma

Karma is a JavaScript Test Runner, one of the most popular and friendliest for beginners. The most notable advantage of Karma is testing in real browsers. See my StackOverflow answer for more information about Karma usage.

On the AngularJS team, we rely on testing and we always seek better tools to make our life easier. That's why we created Karma - a test runner that fits all our needs.

Why?

  • Many setups are bloated with unnecessary options and packages.
  • Start clean and minimal and extend as you go.
  • Add single package to your project instead of many, to get your tests up and running.

Use cases

Features

  • Minimal functional Karma config file.

  • Use as repository (git clone) or package (npm install).

  • Installs all testing packages as dependencies, no need to install them manually.

  • Includes Chrome and Firefox launchers (but many other browsers are also supported).

  • Automatically and gracefully (without overwriting) copied to your project directory via gently-copy:

    • Basic testing example inside demo folder.

    • Minimal functional configuration file karma.conf.js (will not install if karma.conf.js is already present):

      module.exports = function (config) {
        config.set({
          frameworks: ['jasmine'],
          files: [
            'demo/**/*.js'
          ],
          browsers: ['Chrome']
        })
      }
      

If you are new to Node

Download and Install Node.js, see How do I get started with Node.js for more information.

To use as separate Repository:

Clone

git clone https://github.com/dmitriz/min-karma

or simply Download this Repository, unzip it and cd min-karma-master.

Install dependencies

npm install --save-dev

To use as Package (add to your project):

In your main project directory (should contain package.json):

npm install min-karma --save

Getting started

Run your tests:

karma start

Now try to edit files inside demo folder and see how karma is watching and updating your test results.

Basic testing demo — inside demo folder

// function to test
function add (a, b) {
  return a + b
}

// the test
describe('Addition', function () {
  it('should add numbers', function () {
    expect(add(2, 4)).toBe(6)
    expect(add(2, 4)).not.toBe(2)
  })
})

Tip. Keep your tests next to their testees for better cohesion. Avoid putting them into separate folders (like tests) away from your code.

Enjoy! 🎉

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100
No reviews found
Be the first to rate

Alternatives

No alternatives found

Tutorials

No tutorials found
Add a tutorial