Fully-featured, lightweight command-line test runner
npm install test-runner
This project and documentation are a WIP
Fully-featured, lightweight command-line test runner. Part of a suite of tools to help the full-stack JavaScript engineer create and test modern, isomorphic code.
As input, test-runner takes one or more files each exporting a set of tests. The tests in each file are run with a controllable order and concurrency, a report is printed and the command exits with a non-zero code if anything failed.
This is the general syntax (see here for the full usage guide):
``
$ test-runner [
A test file is a module (either CommonJS or ECMAScript) which must export a test object model instance. This test file can be run natively (no build or transpilation step required) in Node.js, the browser (in headless Chromium) or both (isomorphic).
Add tests to the model by invoking tom.test with a name and test function. Trivial example. If a test function throws or returns a rejected promise it is considered a fail, otherwise a pass.
`js
const { Tom } = require('test-runner')
const tom = new Tom()
tom.test('A successful sync test', function () {
return 'This passed'
})
tom.test('A failing sync test', function () {
throw new Error('This failed')
})
tom.test('A successful async test', async function () {
return 'This passed'
})
tom.test('A failing async test', async function () {
throw new Error('This failed')
})
tom.test('Also a failing async test', async function () {
return Promise.reject(new Error('This failed'))
})
module.exports = tom
`
In reality, a typical test suite might look more like this. Save this as test.js.
`js
const { Tom } = require('test-runner')
const assert = require('assert').strict
const fetch = require('node-fetch')
const tom = new Tom()
tom.test('Math.random() should return a number between 0 and 1', function () {
const result = Math.random()
assert.equal(typeof result, 'number')
assert.ok(result >= 0 && result <= 1)
})
tom.test('REST API should return the current todo item', async function () {
const response = await fetch('https://jsonplaceholder.typicode.com/todos/1')
const todo = await response.json()
assert.equal(todo.userId, 1)
assert.equal(todo.title, 'delectus aut autem')
})
module.exports = tom
`
Run the test file using test-runner.
`
$ npx test-runner test.js
Start: 2 tests loaded
ā synopsis Math.random() should return a number between 0 and 1
ā synopsis REST API should return the current todo item
Completed in 199ms. Pass: 2, fail: 0, skip: 0.
`
* How to test ECMAScript modules using Node.js
* How to test ECMAScript modules in the browser
`
$ npm install --save-dev test-runner
Alternatively, you can run your tests with any of the following runners - each is compatible with test-object-model.
| Environment | Description | Tool |
| ----------- | ------------------------ | ------------- |
| Web | Run your tests in a headless Chromium browser from the command line | web-runner |
| Node.js | Test ECMAScript modules natively in Node.js | esm-runner |
Please see the wiki for more examples.
*
© 2016-24 Lloyd Brookes \