🐭 @ugate/labrat

🐁 Run @hapi/lab tests on vanilla test suites

npm install -D @ugate/labrat

test/lib/tester.js:

1// vanilla test suite (all tests should be static)
2
3const { Labrat, LOGGER } = require('@ugate/labrat');
4
5class Tester {
6
7  static async before() {
8    // OPTIONAL: run before all tests
9  }
10
11  static async after() {
12    // OPTIONAL: run after all tests
13  }
14
15  static async beforeEach() {
16    // OPTIONAL: run before each test
17  }
18
19  static async afterEach() {
20    // OPTIONAL: run after each test
21  }
22
23  static myTest1() {
24    if (LOGGER.info) LOGGER.info('Show this when info level enabled');
25    // test here
26  }
27
28  static async myTest2() {
29    Labrat.header('My Test #2');
30    // test here
31  }
32
33  static async testException() {
34    // do something that throws an error
35    throw new Error('TEST Error');
36  }
37}
38
39// when not ran in a test runner execute static Tester static functions
40if (!Labrat.usingTestRunner()) {
41  (async () => await Labrat.run(Tester))();
42}

test/tester.js:

1const Lab = require('@hapi/lab');
2const Tester = require('./lib/tester');
3const lab = Lab.script();
4exports.lab = lab;
5
6const plan = `Demo`;
7
8lab.experiment(plan, () => {
9
10  if (Tester.before) lab.before(Tester.before);
11  if (Tester.after) lab.after(Tester.after);
12  if (Tester.beforeEach) lab.beforeEach(Tester.beforeEach);
13  if (Tester.afterEach) lab.afterEach(Tester.afterEach);
14
15  lab.test(`${plan}: Test #1`, { timeout: 1000 }, Tester.myTest1);
16  lab.test(`${plan}: Test #2`, { timeout: 1000 }, Tester.myTest2);
17  lab.test(`${plan}: Test Error`, { timeout: 1000 },
18    Labrat.expectFailure('onUnhandledRejection', { expect, label: 'throw error' }, Tester.testException)
19  );
20});

Log Levels

• -NODE_ENV=development or -NODE_ENV=dev - All levels/functions included in console
• -NODE_ENV=test - Includes console.info, console.warn, console.error
• -NODE_ENV=production or -NODE_ENV=prod - Includes console.warn, console.error
• Omit or set to another environment to disable logging

Running Tests

Tests can be ran in a Node.js command or in @hapi/lab.

Run in node:

node test/lib/tester.js -NODE_ENV=test

Run myTest1 in node:

node test/lib/tester.js -NODE_ENV=test myTest1

Run in @hapi/lab:

"node_modules/.bin/lab" test/tester.js -v

Run myTest1 in @hapi/lab:

"node_modules/.bin/lab" test/tester.js -vi 1

Run myTest2 in @hapi/lab:

"node_modules/.bin/lab" test/tester.js -vi 2

API

Table of Contents

• header
  • Parameters
• expectFailure
  • Parameters
• wait
  • Parameters
• usingTestRunner

header

Logs a message with header formatting

Parameters

• msg String The message to log
• level String The log level to execute (optional, default 'info')

expectFailure

Convenience function that will handle expected thrown errors

Parameters

• type (String | Array<String>) The flags type/name that will be set on incoming flags (e.g. onUnhandledRejection, onUncaughtException, etc.)
• opts Object The failure options
  • opts.expect Function The @hapi/code expect function
  • opts.label String? The label that will be used for expect
  • opts.code String? The Error.code that will be expected
• func Function A test function with a signature of async function(flags) that @hapi/lab accepts

wait

Async test that will either resolve/reject after a given amount of time

Parameters

• delay Integer The delay in milliseconds to wait before resolving/rejecting
• val any? The value to return when resolved or error message/Error when rejecting
• rejectIt Boolean? true to reject, otherwise resolve

usingTestRunner

Returns Boolean true when the process is being ran from a test utility