resin-config-karma
Base Resin.io Karma Test Runner configuration
Installation
Install resin-config-karma
by running:
$ npm install --save-dev resin-config-karma
Setup
This module aims to provide a base Karma configuration for Resin.io NPM modules. It's preconfigured with the following assumptions about the modern resin.io modules structure:
- The distribution files are located in the
build
folder (typically created by building the TS or ES6+ sources) and have the.js
extension. - The sources are located in
src
orlib
folder and are in JS (ES) or TS. - The test specs are located in the
tests
folder and have the double.spec.js
or.spec.ts
extension. - The tests are importing the distribution or the source files.
It's recommended to simply import the root of the project and let
node
decide what to do, as in the real usage scenario. It has the benefit of importing TS if thetypes
entry is properly configured inpackage.json
.
It supports the following features:
- Webpack transform for the tests bundle with ES2015 support and sourcemaps.
- Test are run in headless Chrome.
- SauceLabs configuration.
- Mocha support.
- CI mode enabled by default.
The module exposes a function returning the Karma configuration object
that you can pass to config.set()
yourself.
To get started, create a karma.conf.js
in the root of your project:
var getKarmaConfig = ;var packageJSON = ; module { var karmaConfig = // Notice you can override the default options as you wish karmaConfiglogLevel = configLOG_INFO; config;};
And run karma start
.
SauceLabs
This configuration allows to easily setup your tests to run in SauceLabs by setting the following environment variables:
export SAUCE_LABS=trueexport SAUCE_USERNAME=<username>export SAUCE_ACCESS_KEY=<access key>
If SAUCE_LABS
is not set, karma
will only run the tests locally on Chrome.
Browsers
The local tests run in the headless Chrome.
To run them locally you need Chrome >= 59 installed.
To run them on Travis add the following lines to your .travis.yml
file:
dist: trustysudo: falseaddons: chrome: stable
Note: change false
to required
if you need sudo for your tests, see the Travis Trusty docs and the Travis container-based infrastructure docs for more details.
AppVeyor has the the proper Chrome version preinstalled.
The SauceLabs tests run in the browsers specified in launchers.json.
Support
If you're having any problem, please raise an issue on GitHub and the Resin.io team will be happy to help.