Tramvai test unit

Helpers library for writing tramvai specific unit-tests

It might be even more useful when used with @tramvai/test-mocks

Installation

1npm i --save-dev @tramvai/test-unit

How to

Testing reducers

1import { testReducer } from '@tramvai/test-unit';
2
3it('test', async () => {
4  const { dispatch, getState } = testReducer(reducer);
5
6  expect(getState()).toEqual([]);
7
8  dispatch(event(1));
9
10  expect(getState()).toEqual([1]);
11});

More examples

@inline src/state/testReducer.spec.ts

Testing actions

Tramvai context and DI will be created automatically, otherwise you can directly pass it as an argument.

1import { testAction } from '@tramvai/test-unit';
2
3it('test', async () => {
4  const { run, context } = testAction(action, { initialState: { a: 1 } });
5
6  expect(await run(true)).toBe('hello');
7  expect(await run(false)).toBe('world');
8
9  context.getState(); // { a: 1 }
10});

More examples

@inline src/state/testAction.spec.ts

Testing tramvai module

Testing module in isolation

1import { testModule } from '@tramvai/test-unit';
2
3it('test', async () => {
4  const { di, module, runLine } = testModule(TestModule);
5
6  expect(module).toBeInstanceOf(TestModule);
7  expect(di.get('testToken')).toEqual({ a: 1 });
8
9  // Run only specific command line in order to execute handlers for this line inside module
10  await runLine(commandLineListTokens.generatePage);
11});

Testing module in conjunction with other modules

1import { createTestApp } from '@tramvai/test-unit';
2
3it('test', async () => {
4  const { app } = await createTestApp({ modules: [TestModule, DependentModule] });
5
6  // get tokens from di implemented by module
7  expect(app.di.get('testToken')).toEqual({ a: 1 });
8});

More examples

@inline src/module/testModule.spec.ts

Adding providers to DI

Most of the helpers accepts option providers which allows to redefine already existing providers or add new.

For example, passing providers to helper testAction allows to access this provider inside action itself:

1import { declareAction } from '@tramvai/core';
2import { testAction } from '@tramvai/test-unit';
3
4const action = declareAction({
5  name: 'action',
6  fn() {
7    console.log(this.deps.test); // token value
8  },
9  deps: {
10    test: 'token name',
11  },
12});
13
14it('test', async () => {
15  const { run } = testAction(action, {
16    providers: [
17      {
18        provide: 'token name',
19        useValue: 'token value',
20      },
21    ],
22  });
23});

Create app only for testing

1import { createTestApp } from '@tramvai/test-unit';
2
3it('test', async () => {
4  const { app } = await createTestApp({ modules: [TestModule, DependentModule] });
5
6  // get tokens from di implemented by module
7  expect(app.di.get('testToken')).toEqual({ a: 1 });
8});

More examples

@inline src/app/createTestApp.spec.ts