You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
2.1 KiB
2.1 KiB
Gunner
Tiny, but fully loaded.
Gunner is a zero magic, fast test-runner and assertion framework. There are no magic globals or CLI specific interface.
Requirements & Usage
Gunner uses very modern JavaScript, and hence requires node 10+ currently.
Create a new Gunner instance and simply write your tests. The assertion methods are passed in as the callback to the test function.
const gunner = new Gunner();
gunner.test('arrays are equal', expect => {
return expect([1, 2,]).deepEqual([1 ,2]);
});
gunner.run();
API
Gunner.constructor
Gunner#test(title, implementation)
Gunner#run(options)
new Gunner
Creates a new Gunner instance.
Options
name[default: undefined]: A name for this Gunner instance.
Usage
const gunner = new Gunner(options);
Gunner#test
Registers a new test. A test can have multiple expect statements. They should be returned as an array. The first expect to fail will cause the test to fail.
Usage
gunner.test('sum should equal 3', expect => {
const sum = 1 + 2;
return expect(sum).equal(3);
});
Expecting multiple results:
gunner.test('multiple expects should be true', expect => {
const a = 1 + 2;
const b = 'Hello World';
return ([
expect(a).equal(3),
expect(b).equal('Goodbye World'),
]);
});
Asynchronous tests:
gunner.test('asynchronous test', async expect => {
const response = await axios.post(url, request);
const userObject = await db.find('userdetails', { username });
return [
expect(response.status).equal(200);
expect(userObject).deepEquals(testUser);
];
})
Gunner#run
Starts running Gunner tests. Takes an options object as optional parameter.
Options
log[default: true]: Turn logs on or off (returns array of results)trace[default: false]: Turn stack traces on or off
Usage
const options = { logs: true, trace: true };
gunner.run(options);