@jenkins-cd/js-builder-jest
v0.0.4
Published
Adds support for running tests with Jest via Jenkins js-builder
Downloads
1,702
Keywords
Readme
Jest support for Jenkins JS Builder
Run your tests with Jenkins JS Builder using the "Jest" test runner.
Setup
Add a gulpfile with the following line:
const jsb = require('@jenkins-cd/js-builder');
Install the
@jenkins-cd/js-builder-jest
dependency.Setup npm scripts
It is convenient to invoke js-builder-jest via npm scripts. Add the following to the "scripts" block in package.json:
"test": "gulp test", "test:fast": "gulp test:fast", "test:debug": "node --debug-brk ./node_modules/.bin/gulp test:debug",
Defaults
The default location for tests is the test
folder. This can be overridden by calling builder.tests(<new-path>
in the gulpfile.
The file names need to match the pattern *-spec.js
or *-test.js
; the jsx
extension is also supported.
'test' Task
Run the tests and produces test and coverage reports.
You can limit the tests that are run via the test
parameter. This is a pattern that is passed to Jest's testPathPattern CLI parameter.
JUnit test reports are stored in target/jest-reports/
and coverage reports in target/jest-coverage/
.
Note that coverage is only measured for .js and .jsx files in the source directories (default: src
).
'test:fast" Task
npm run test:fast
Runs the tests but skips generation of reports and coverage. This is good for local development.
'test:debug' Task
npm run test:debug
Runs the tests in debug mode on default port 5858. Test execution will be paused until the debugger is attached and execution is resumed.
Running specific tests
Run a single test.
npm run test -- --test test/src/js/foo/bar/foobar-spec
Runs any test with 'calculator' in the path or name.
npm run test -- --test calculator
Run any test inside of a 'math' folder.
npm run test -- --test /math/
Using custom configuration
Jest configuration
Jest's command line runner supports custom configuration placed in a "jest" property in package.json. js-builder-jest
will automatically add these configuration options if they are defined.
Jest CLI Options
Jest also supports useful CLI options. These can be used in two ways:
In npm scripts
"test:fast": "gulp test:fast --updateSnapshot",
From command line
npm run test:fast -- --updateSnapshot
Note the double dash above.