min-karma
v3.0.0
Published
Minimal Karma Runner setup
Downloads
168
Maintainers
Readme
min-karma
Minimal Karma runner Setup and Package — Start testing now!
Other minimal setups
And their combinations:
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
- You have a project and want to add unit/integration/whatever tests — install the package.
- You want to quickly evaluate Karma runner and play with in a clean folder — clone or download the repository.
Features
- [x] Minimal functional Karma config file.
- [x] Use as repository (
git clone
) or package (npm install
). - [x] Installs all testing packages as dependencies, no need to install them manually.
- [x] Includes Chrome and Firefox launchers (but many other browsers are also supported).
- [x] Automatically and gracefully (without overwriting) copied to your project directory via
gently-copy
:[x] Basic testing example inside
demo
folder.[x] Minimal functional configuration file
karma.conf.js
(will not install ifkarma.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! :tada: