TypeScript icon, indicating that this package has built-in type declarations

1.0.0 • Public • Published

Welcome to Awesome Nodes Unittest Library 👋

Version Documentation Code Style: 4-space K&R. License: MIT

🔎 Unittest OO framework for converting functional unittest lifecycle hooks into callable object model signatures
Provides implementation of reusable test case signatures.

🏠 Homepage


Write Awesome Unittests

  1. Inject the lifecycle functions of your unittest framework (jest, jasmine, mocha, ...)

    • afterAll

    • afterEach

    • beforeAll

    • beforeEach


    Create an index.ts file located at your unittest configuration directory (usually src/unittest) and paste the following contents:

    import { AFTER_ALL_TOKEN, AFTER_EACH_TOKEN, BEFORE_ALL_TOKEN, BEFORE_EACH_TOKEN } from '@awesome-nodes/unittest';
    AFTER_ALL_TOKEN.scope.addProvider({ provide: AFTER_ALL_TOKEN, useValue: afterAll, scope: AFTER_ALL_TOKEN.Scope });
    AFTER_EACH_TOKEN.scope.addProvider({ provide: AFTER_EACH_TOKEN, useValue: afterEach, scope: AFTER_EACH_TOKEN.Scope });
    BEFORE_ALL_TOKEN.scope.addProvider({ provide: BEFORE_ALL_TOKEN, useValue: beforeAll, scope: BEFORE_ALL_TOKEN.Scope });
    BEFORE_EACH_TOKEN.scope.addProvider({ provide: BEFORE_EACH_TOKEN, useValue: beforeEach, scope: BEFORE_EACH_TOKEN.Scope });
    export * from '@awesome-nodes/unittest';
  2. Adjust your tsconfig.json

      "compilerOptions": {
        "paths": {
          "unittest": ["src/unittest"],
  3. Write awesome unittests


    import { itShould, TestCase } from 'unittest';
    class AwesomeTestCase extends TestCase
        test(): void
            itShould('test things the awesome way', () =>
                // Arrange
                // Act
                // Assert
    new AwesomeTestCase;

    A full example is available in src/unittest/TestCase.spec.ts.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.



git clone git+ssh://git@gitlab.com/awesome-nodes/unittest.git


cd unittest
npm install


npm run start

Run Unit Tests

Single Run:

npm run test

Run in watch mode:

npm run test:w

Run TypeScript Check

Single Run:

npm run tscheck

Run in watch mode:

npm run tscheck:w

Run Circular Dependency Check

npm run tscheck:circular

Run Coding Style Tests

npm run eslint

Run Build

The build output contains three kinds of library variants:

  • ES5 for NodeJS applications
  • ES6 for tree shaking builds
  • and a UMD bundle for web applications
npm run build


Deployment is done by publishing the npm package using:

npm publish

Built With

  • BuildSystem - Integrated Zero Configuration Build System for Awesome Nodes Apps and Framework Components

👤 Authors

See also the list of contributors who participated in this project.

🤝 Contributing

Contributions, issues and feature requests are welcome!
Feel free to check our issues page.

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Please read the DEVELOPING.md for details on how to develop this repository.


We use SemVer for versioning. For the versions available, see the tags on this repository.

Show your support

Give a ⭐️ if this project helped you!



This README was generated initially with ❤️ by readme-md-generator

Package Sidebar


npm i @awesome-nodes/unittest

Weekly Downloads






Unpacked Size

119 kB

Total Files


Last publish


  • christian.kusmanow
  • markusfaatz