Testing Framework

Overview
Testing is an integral part of any application. We therefore have a node module and guidelines to testing a Blueprint application. We use the following middleware to facilitate testing:
​chai​
​chai-datetime​
​mocha​
​superagent​
​supertest​
The remainder of this section will detail how to write test for Blueprint.
Installation
The testing module is automatically installed when you generate a new Blueprint project. But, in case you need to manually install it, or update to the latest version, use the following command.
1
npm install --save-dev @onehilltech/blueprint-testing 
Copied!
Do not forget to the --save-dev option when installing the blueprint-testing module.
Running Test Cases
The simplest way to run your test cases is via npm on the command-line.
1
npm test
Copied!
This will instruct npm to run all test cases in your tests/unit-tests.
Using an IDE
npm is just one way to run your test cases, but you are not restricted to only using npm. You can use your favorite IDE to run your tests cases, such as WebStorm. If you choose to run your test cases via an IDE, you must remember that tests/unit-tests/bootstrap.js must load first  before running any test cases. This file will load your Blueprint application into memory, and make the application resources available for testing. If you fail to load this file first during your testing exercises, you will get error messages related to the application not being loaded. A common solution to ensure tests/unit-tests/bootstrap.js loads first is to set tests/unit-tests as the starting directory for your unit tests.
Testing Routes
You test different routes in Blueprint by sending requests to paths on the Blueprint application under test. For example, the message router from our previous examples defined the route POST /messages. We can test this route by sending a request a POST request to /messages.
tests/unit-tests/app/routers/message-test.js
1
const { request } = require ('@onehilltech/blueprint-testing');
2
​
3
describe ('app | routers | message', function () {
4
  it ('should create a message', function () {
5
    const message = { 
6
      id: 0, 
7
      to: '[email protected]',
8
      from: '[email protected]',
9
      date: Date.now (), 
10
      subject: 'Dummy Message',
11
      content; 'This is a dummy message.'
12
    };
13
    
14
    return request ()
15
      .post ('/messages')
16
      .send ({message})
17
      .expect (200, {message});
18
  });
19
});
Copied!
As shown in the example above, we start by importing the request method from blueprint-testing. The request method is a helper method that will return a supertest request object that initiates a http request against the Blueprint application. The request has the option of returning a Promise that can be returned from the unit testing method to signify asynchronous execution.
Testing Blueprint Modules

Technical Details

Command-line Interface (Coming Soon)

Last modified 3mo ago

Copy link

Contents

Testing Blueprint Modules